@kb1rma/libcomm14cux-ts 0.2.0-beta.7 → 0.2.1-beta.9

package/dist/transport/simulated.d.ts

@@ -1,4 +1,17 @@
 import type { Transport } from './types.js';
+/**
+ * Where a memory write injected by {@link SimulatedTransport.failMemoryWritesAfter}
+ * goes wrong:
+ *
+ * - `'commandLost'`: the write command never reaches the ECU. No echo, and
+ *   nothing is stored.
+ * - `'commandEchoCorrupted'`: the ECU takes the write command, but its echo
+ *   is garbled on the way back. The ECU then waits for the value byte.
+ * - `'valueEchoLost'`: the ECU stores the value, but its echo is lost.
+ * - `'valueEchoCorrupted'`: the ECU stores the value, but its echo is garbled
+ *   on the way back.
+ */
+export type MemoryWriteFault = 'commandLost' | 'commandEchoCorrupted' | 'valueEchoLost' | 'valueEchoCorrupted';
 /**
  * Emulates the ECU's side of the serial protocol over an in-memory 64 KiB
  * address space. Used for tests and for developing a UI without a car.
@@ -15,8 +28,34 @@ export declare class SimulatedTransport implements Transport {
     silent: boolean;
     /** Fault injection: reject every write. */
     failWrites: boolean;
+    /**
+     * Fault injection: where a write failed by
+     * {@link SimulatedTransport.failMemoryWritesAfter} goes wrong. Defaults to
+     * `'commandLost'`.
+     */
+    memoryWriteFault: MemoryWriteFault;
+    /**
+     * How long the ECU waits, with nothing received, before it drops a
+     * half-received command, in milliseconds. A read that times out counts as
+     * that much silence.
+     */
+    commandTimeoutMs: number;
     /** Fault injection: stream at most this many bytes per read command. */
     streamLimit: number | undefined;
+    /**
+     * Fault injection: let this many memory writes succeed, then fail every
+     * later one, while reads keep working. `undefined` (the default) never
+     * fails; `0` fails the first. Setting it starts the count again.
+     *
+     * @returns The number of memory writes allowed to succeed.
+     */
+    get failMemoryWritesAfter(): number | undefined;
+    /**
+     * Sets the memory-write fault limit and starts the count again.
+     *
+     * @param count - Memory writes to allow before failing, or `undefined` for none.
+     */
+    set failMemoryWritesAfter(count: number | undefined);
     /**
      * Whether the transport is open.
      *
@@ -55,11 +94,12 @@ export declare class SimulatedTransport implements Transport {
      * Takes bytes from the simulated ECU's reply.
      *
      * @param length - Number of bytes wanted.
-     * @param _timeoutMs - Ignored; the simulation answers immediately.
+     * @param timeoutMs - The simulation answers at once, but a read that times
+     * out counts as this much silence on the line.
      * @returns Exactly `length` bytes.
      * @throws {@link TimeoutError} if the ECU has not produced that many bytes.
      * @throws {@link NotConnectedError} if the transport is closed.
      */
-    read(length: number, _timeoutMs: number): Promise<Uint8Array>;
+    read(length: number, timeoutMs: number): Promise<Uint8Array>;
 }
 //# sourceMappingURL=simulated.d.ts.map

package/dist/transport/simulated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulated.d.ts","sourceRoot":"","sources":["../../src/transport/simulated.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyB5C;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,SAAS;;IAClD,sEAAsE;IACtE,QAAQ,CAAC,MAAM,0BAA+B;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IAEhC,oDAAoD;IACpD,eAAe,UAAS;IACxB,oCAAoC;IACpC,MAAM,UAAS;IACf,2CAA2C;IAC3C,UAAU,UAAS;IACnB,wEAAwE;IACxE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAa;IAW5C;;;;OAIG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQhC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtC;;;;;;;;OAQG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA8E9D"}
+{"version":3,"file":"simulated.d.ts","sourceRoot":"","sources":["../../src/transport/simulated.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,sBAAsB,GACtB,eAAe,GACf,oBAAoB,CAAC;AA4BzB;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,SAAS;;IAClD,sEAAsE;IACtE,QAAQ,CAAC,MAAM,0BAA+B;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAM;IAEhC,oDAAoD;IACpD,eAAe,UAAS;IACxB,oCAAoC;IACpC,MAAM,UAAS;IACf,2CAA2C;IAC3C,UAAU,UAAS;IACnB;;;;OAIG;IACH,gBAAgB,EAAE,gBAAgB,CAAiB;IACnD;;;;OAIG;IACH,gBAAgB,SAAgC;IAChD,wEAAwE;IACxE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAa;IAgB5C;;;;;;OAMG;IACH,IAAI,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAE9C;IAED;;;;OAIG;IACH,IAAI,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAGlD;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQhC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtC;;;;;;;;;OASG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAoH7D"}

package/dist/transport/simulated.js

@@ -5,6 +5,12 @@
 import { NotConnectedError, TimeoutError } from '../errors.js';
 import { DataSize, MemoryOffset, ReadCountValue } from '../constants.js';
 const MEMORY_SIZE = 0x10000;
+/**
+ * How long the simulated ECU waits, with nothing received, before it drops a
+ * half-received command. The real firmware does this after 256 passes of its
+ * main loop; the time that takes is not documented and varies with load.
+ */
+const SIMULATED_COMMAND_TIMEOUT_MS = 250;
 function lengthFromCode(code) {
     if (code <= 0x0f) {
         return code + 1;
@@ -37,6 +43,18 @@ export class SimulatedTransport {
     silent = false;
     /** Fault injection: reject every write. */
     failWrites = false;
+    /**
+     * Fault injection: where a write failed by
+     * {@link SimulatedTransport.failMemoryWritesAfter} goes wrong. Defaults to
+     * `'commandLost'`.
+     */
+    memoryWriteFault = 'commandLost';
+    /**
+     * How long the ECU waits, with nothing received, before it drops a
+     * half-received command, in milliseconds. A read that times out counts as
+     * that much silence.
+     */
+    commandTimeoutMs = SIMULATED_COMMAND_TIMEOUT_MS;
     /** Fault injection: stream at most this many bytes per read command. */
     streamLimit = undefined;
     #open = false;
@@ -47,6 +65,30 @@ export class SimulatedTransport {
     #latched = false;
     #lengthCode = 0;
     #writeAddr = 0;
+    #failMemoryWritesAfter = undefined;
+    #memoryWritesDone = 0;
+    #failingWrite = false;
+    #lastByteAt = 0;
+    #quietMs = 0;
+    /**
+     * Fault injection: let this many memory writes succeed, then fail every
+     * later one, while reads keep working. `undefined` (the default) never
+     * fails; `0` fails the first. Setting it starts the count again.
+     *
+     * @returns The number of memory writes allowed to succeed.
+     */
+    get failMemoryWritesAfter() {
+        return this.#failMemoryWritesAfter;
+    }
+    /**
+     * Sets the memory-write fault limit and starts the count again.
+     *
+     * @param count - Memory writes to allow before failing, or `undefined` for none.
+     */
+    set failMemoryWritesAfter(count) {
+        this.#failMemoryWritesAfter = count;
+        this.#memoryWritesDone = 0;
+    }
     /**
      * Whether the transport is open.
      *
@@ -113,22 +155,24 @@ export class SimulatedTransport {
      * Takes bytes from the simulated ECU's reply.
      *
      * @param length - Number of bytes wanted.
-     * @param _timeoutMs - Ignored; the simulation answers immediately.
+     * @param timeoutMs - The simulation answers at once, but a read that times
+     * out counts as this much silence on the line.
      * @returns Exactly `length` bytes.
      * @throws {@link TimeoutError} if the ECU has not produced that many bytes.
      * @throws {@link NotConnectedError} if the transport is closed.
      */
-    read(length, _timeoutMs) {
+    read(length, timeoutMs) {
         if (!this.#open) {
             return Promise.reject(new NotConnectedError('Transport is not open'));
         }
         if (this.#output.length < length) {
             this.#output = [];
+            this.#quietMs += timeoutMs;
             return Promise.reject(new TimeoutError('Simulated ECU is silent'));
         }
         return Promise.resolve(Uint8Array.from(this.#output.splice(0, length)));
     }
-    #echo(byte) {
+    #echo(byte, garbled = false) {
         if (this.silent) {
             return;
         }
@@ -137,13 +181,28 @@ export class SimulatedTransport {
             this.#output.push(byte ^ 0xff);
         }
         else {
-            this.#output.push(byte);
+            this.#output.push(garbled ? byte ^ 0xff : byte);
         }
     }
     #receive(byte) {
+        const now = Date.now();
+        // Like the firmware, drop a half-received command after a long enough
+        // silence. The address already latched is kept.
+        if (this.#state !== 'idle' &&
+            now - this.#lastByteAt + this.#quietMs >= this.commandTimeoutMs) {
+            this.#state = 'idle';
+        }
+        this.#lastByteAt = now;
+        this.#quietMs = 0;
         if (this.#state === 'writeValue') {
             this.memory[this.#writeAddr] = byte;
-            this.#echo(byte);
+            if (!this.#failingWrite) {
+                this.#memoryWritesDone += 1;
+                this.#echo(byte);
+            }
+            else if (this.memoryWriteFault !== 'valueEchoLost') {
+                this.#echo(byte, this.memoryWriteFault === 'valueEchoCorrupted');
+            }
             this.#state = 'idle';
             this.#latched = false;
             return;
@@ -169,11 +228,19 @@ export class SimulatedTransport {
             this.#streamRead(this.#coarse | (byte & 0x3f));
         }
         else {
+            this.#failingWrite = this.#memoryWriteFails();
+            if (this.#failingWrite && this.memoryWriteFault === 'commandLost') {
+                return;
+            }
             this.#writeAddr = this.#coarse | (byte & 0x3f);
-            this.#echo(byte);
+            this.#echo(byte, this.#failingWrite && this.memoryWriteFault === 'commandEchoCorrupted');
             this.#state = 'writeValue';
         }
     }
+    #memoryWriteFails() {
+        return (this.#failMemoryWritesAfter !== undefined &&
+            this.#memoryWritesDone >= this.#failMemoryWritesAfter);
+    }
     #streamRead(address) {
         if (this.silent) {
             return;

package/dist/transport/simulated.js.map

@@ -1 +1 @@
-{"version":3,"file":"simulated.js","sourceRoot":"","sources":["../../src/transport/simulated.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\nimport { NotConnectedError, TimeoutError } from '../errors.js';\nimport { DataSize, MemoryOffset, ReadCountValue } from '../constants.js';\nimport type { Transport } from './types.js';\n\nconst MEMORY_SIZE = 0x10000;\n\ntype State = 'idle' | 'coarse2' | 'writeValue';\n\nfunction lengthFromCode(code: number): number | undefined {\n  if (code <= 0x0f) {\n    return code + 1;\n  }\n\n  switch (code) {\n    case ReadCountValue.Count1:\n      return 0x50;\n    case ReadCountValue.Count2:\n      return 0x64;\n    case ReadCountValue.Count3:\n      return 0x190;\n    case ReadCountValue.Count4:\n      return 0x200;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Emulates the ECU's side of the serial protocol over an in-memory 64 KiB\n * address space. Used for tests and for developing a UI without a car.\n */\nexport class SimulatedTransport implements Transport {\n  /** The ECU's address space. Tests may read and modify it directly. */\n  readonly memory = new Uint8Array(MEMORY_SIZE);\n  /** Every byte written to the ECU, in order. */\n  readonly written: number[] = [];\n\n  /** Fault injection: invert the next echoed byte. */\n  corruptNextEcho = false;\n  /** Fault injection: never reply. */\n  silent = false;\n  /** Fault injection: reject every write. */\n  failWrites = false;\n  /** Fault injection: stream at most this many bytes per read command. */\n  streamLimit: number | undefined = undefined;\n\n  #open = false;\n  #state: State = 'idle';\n  #output: number[] = [];\n  #firstCoarse = 0;\n  #coarse = 0;\n  #latched = false;\n  #lengthCode = 0;\n  #writeAddr = 0;\n\n  /**\n   * Whether the transport is open.\n   *\n   * @returns `true` between {@link SimulatedTransport.open} and {@link SimulatedTransport.close}.\n   */\n  get isOpen(): boolean {\n    return this.#open;\n  }\n\n  /**\n   * Places a 16 KiB firmware image at 0xC000 to 0xFFFF.\n   *\n   * @param image - The ROM image, exactly 0x4000 bytes.\n   * @throws {@link RangeError} if the image is the wrong size.\n   */\n  loadRom(image: Uint8Array): void {\n    if (image.length !== DataSize.ROM) {\n      throw new RangeError(`ROM image must be ${DataSize.ROM} bytes`);\n    }\n\n    this.memory.set(image, MemoryOffset.ROMAddress);\n  }\n\n  /**\n   * Opens the simulated link.\n   *\n   * @returns A promise that resolves immediately.\n   */\n  open(): Promise<void> {\n    this.#open = true;\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Closes the simulated link and discards any pending ECU output.\n   *\n   * @returns A promise that resolves immediately.\n   */\n  close(): Promise<void> {\n    this.#open = false;\n    this.#state = 'idle';\n    this.#latched = false;\n    this.#output = [];\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Delivers bytes to the simulated ECU, which may queue a reply.\n   *\n   * @param data - Bytes to send.\n   * @returns A promise that resolves once the bytes are delivered.\n   * @throws {@link NotConnectedError} if the transport is closed.\n   * @throws Error if {@link SimulatedTransport.failWrites} is set.\n   */\n  write(data: Uint8Array): Promise<void> {\n    if (!this.#open) {\n      return Promise.reject(new NotConnectedError('Transport is not open'));\n    }\n\n    if (this.failWrites) {\n      return Promise.reject(new Error('Simulated write failure'));\n    }\n\n    for (const byte of data) {\n      this.written.push(byte);\n      this.#receive(byte);\n    }\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Takes bytes from the simulated ECU's reply.\n   *\n   * @param length - Number of bytes wanted.\n   * @param _timeoutMs - Ignored; the simulation answers immediately.\n   * @returns Exactly `length` bytes.\n   * @throws {@link TimeoutError} if the ECU has not produced that many bytes.\n   * @throws {@link NotConnectedError} if the transport is closed.\n   */\n  read(length: number, _timeoutMs: number): Promise<Uint8Array> {\n    if (!this.#open) {\n      return Promise.reject(new NotConnectedError('Transport is not open'));\n    }\n\n    if (this.#output.length < length) {\n      this.#output = [];\n\n      return Promise.reject(new TimeoutError('Simulated ECU is silent'));\n    }\n\n    return Promise.resolve(Uint8Array.from(this.#output.splice(0, length)));\n  }\n\n  #echo(byte: number): void {\n    if (this.silent) {\n      return;\n    }\n\n    if (this.corruptNextEcho) {\n      this.corruptNextEcho = false;\n      this.#output.push(byte ^ 0xff);\n    } else {\n      this.#output.push(byte);\n    }\n  }\n\n  #receive(byte: number): void {\n    if (this.#state === 'writeValue') {\n      this.memory[this.#writeAddr] = byte;\n      this.#echo(byte);\n      this.#state = 'idle';\n      this.#latched = false;\n\n      return;\n    }\n\n    if (this.#state === 'coarse2') {\n      this.#coarse = ((this.#firstCoarse & 0x03) << 14) | (byte << 6);\n      this.#lengthCode = (this.#firstCoarse >> 2) & 0x1f;\n      this.#echo(byte);\n      this.#state = 'idle';\n      this.#latched = true;\n\n      return;\n    }\n\n    if (byte < 0x80) {\n      this.#firstCoarse = byte;\n      this.#echo(byte);\n      this.#state = 'coarse2';\n      this.#latched = false;\n    } else if (!this.#latched) {\n      // A command byte without a preceding coarse address is ignored.\n    } else if ((byte & 0xc0) === 0xc0) {\n      this.#streamRead(this.#coarse | (byte & 0x3f));\n    } else {\n      this.#writeAddr = this.#coarse | (byte & 0x3f);\n      this.#echo(byte);\n      this.#state = 'writeValue';\n    }\n  }\n\n  #streamRead(address: number): void {\n    if (this.silent) {\n      return;\n    }\n\n    let length = lengthFromCode(this.#lengthCode) ?? 0;\n\n    if (this.streamLimit !== undefined) {\n      length = Math.min(length, this.streamLimit);\n    }\n\n    for (let i = 0; i < length; i++) {\n      this.#output.push(this.memory[(address + i) % MEMORY_SIZE] ?? 0);\n    }\n  }\n}\n"]}
+{"version":3,"file":"simulated.js","sourceRoot":"","sources":["../../src/transport/simulated.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\nimport { NotConnectedError, TimeoutError } from '../errors.js';\nimport { DataSize, MemoryOffset, ReadCountValue } from '../constants.js';\nimport type { Transport } from './types.js';\n\nconst MEMORY_SIZE = 0x10000;\n\ntype State = 'idle' | 'coarse2' | 'writeValue';\n\n/**\n * Where a memory write injected by {@link SimulatedTransport.failMemoryWritesAfter}\n * goes wrong:\n *\n * - `'commandLost'`: the write command never reaches the ECU. No echo, and\n *   nothing is stored.\n * - `'commandEchoCorrupted'`: the ECU takes the write command, but its echo\n *   is garbled on the way back. The ECU then waits for the value byte.\n * - `'valueEchoLost'`: the ECU stores the value, but its echo is lost.\n * - `'valueEchoCorrupted'`: the ECU stores the value, but its echo is garbled\n *   on the way back.\n */\nexport type MemoryWriteFault =\n  | 'commandLost'\n  | 'commandEchoCorrupted'\n  | 'valueEchoLost'\n  | 'valueEchoCorrupted';\n\n/**\n * How long the simulated ECU waits, with nothing received, before it drops a\n * half-received command. The real firmware does this after 256 passes of its\n * main loop; the time that takes is not documented and varies with load.\n */\nconst SIMULATED_COMMAND_TIMEOUT_MS = 250;\n\nfunction lengthFromCode(code: number): number | undefined {\n  if (code <= 0x0f) {\n    return code + 1;\n  }\n\n  switch (code) {\n    case ReadCountValue.Count1:\n      return 0x50;\n    case ReadCountValue.Count2:\n      return 0x64;\n    case ReadCountValue.Count3:\n      return 0x190;\n    case ReadCountValue.Count4:\n      return 0x200;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Emulates the ECU's side of the serial protocol over an in-memory 64 KiB\n * address space. Used for tests and for developing a UI without a car.\n */\nexport class SimulatedTransport implements Transport {\n  /** The ECU's address space. Tests may read and modify it directly. */\n  readonly memory = new Uint8Array(MEMORY_SIZE);\n  /** Every byte written to the ECU, in order. */\n  readonly written: number[] = [];\n\n  /** Fault injection: invert the next echoed byte. */\n  corruptNextEcho = false;\n  /** Fault injection: never reply. */\n  silent = false;\n  /** Fault injection: reject every write. */\n  failWrites = false;\n  /**\n   * Fault injection: where a write failed by\n   * {@link SimulatedTransport.failMemoryWritesAfter} goes wrong. Defaults to\n   * `'commandLost'`.\n   */\n  memoryWriteFault: MemoryWriteFault = 'commandLost';\n  /**\n   * How long the ECU waits, with nothing received, before it drops a\n   * half-received command, in milliseconds. A read that times out counts as\n   * that much silence.\n   */\n  commandTimeoutMs = SIMULATED_COMMAND_TIMEOUT_MS;\n  /** Fault injection: stream at most this many bytes per read command. */\n  streamLimit: number | undefined = undefined;\n\n  #open = false;\n  #state: State = 'idle';\n  #output: number[] = [];\n  #firstCoarse = 0;\n  #coarse = 0;\n  #latched = false;\n  #lengthCode = 0;\n  #writeAddr = 0;\n  #failMemoryWritesAfter: number | undefined = undefined;\n  #memoryWritesDone = 0;\n  #failingWrite = false;\n  #lastByteAt = 0;\n  #quietMs = 0;\n\n  /**\n   * Fault injection: let this many memory writes succeed, then fail every\n   * later one, while reads keep working. `undefined` (the default) never\n   * fails; `0` fails the first. Setting it starts the count again.\n   *\n   * @returns The number of memory writes allowed to succeed.\n   */\n  get failMemoryWritesAfter(): number | undefined {\n    return this.#failMemoryWritesAfter;\n  }\n\n  /**\n   * Sets the memory-write fault limit and starts the count again.\n   *\n   * @param count - Memory writes to allow before failing, or `undefined` for none.\n   */\n  set failMemoryWritesAfter(count: number | undefined) {\n    this.#failMemoryWritesAfter = count;\n    this.#memoryWritesDone = 0;\n  }\n\n  /**\n   * Whether the transport is open.\n   *\n   * @returns `true` between {@link SimulatedTransport.open} and {@link SimulatedTransport.close}.\n   */\n  get isOpen(): boolean {\n    return this.#open;\n  }\n\n  /**\n   * Places a 16 KiB firmware image at 0xC000 to 0xFFFF.\n   *\n   * @param image - The ROM image, exactly 0x4000 bytes.\n   * @throws {@link RangeError} if the image is the wrong size.\n   */\n  loadRom(image: Uint8Array): void {\n    if (image.length !== DataSize.ROM) {\n      throw new RangeError(`ROM image must be ${DataSize.ROM} bytes`);\n    }\n\n    this.memory.set(image, MemoryOffset.ROMAddress);\n  }\n\n  /**\n   * Opens the simulated link.\n   *\n   * @returns A promise that resolves immediately.\n   */\n  open(): Promise<void> {\n    this.#open = true;\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Closes the simulated link and discards any pending ECU output.\n   *\n   * @returns A promise that resolves immediately.\n   */\n  close(): Promise<void> {\n    this.#open = false;\n    this.#state = 'idle';\n    this.#latched = false;\n    this.#output = [];\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Delivers bytes to the simulated ECU, which may queue a reply.\n   *\n   * @param data - Bytes to send.\n   * @returns A promise that resolves once the bytes are delivered.\n   * @throws {@link NotConnectedError} if the transport is closed.\n   * @throws Error if {@link SimulatedTransport.failWrites} is set.\n   */\n  write(data: Uint8Array): Promise<void> {\n    if (!this.#open) {\n      return Promise.reject(new NotConnectedError('Transport is not open'));\n    }\n\n    if (this.failWrites) {\n      return Promise.reject(new Error('Simulated write failure'));\n    }\n\n    for (const byte of data) {\n      this.written.push(byte);\n      this.#receive(byte);\n    }\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Takes bytes from the simulated ECU's reply.\n   *\n   * @param length - Number of bytes wanted.\n   * @param timeoutMs - The simulation answers at once, but a read that times\n   * out counts as this much silence on the line.\n   * @returns Exactly `length` bytes.\n   * @throws {@link TimeoutError} if the ECU has not produced that many bytes.\n   * @throws {@link NotConnectedError} if the transport is closed.\n   */\n  read(length: number, timeoutMs: number): Promise<Uint8Array> {\n    if (!this.#open) {\n      return Promise.reject(new NotConnectedError('Transport is not open'));\n    }\n\n    if (this.#output.length < length) {\n      this.#output = [];\n      this.#quietMs += timeoutMs;\n\n      return Promise.reject(new TimeoutError('Simulated ECU is silent'));\n    }\n\n    return Promise.resolve(Uint8Array.from(this.#output.splice(0, length)));\n  }\n\n  #echo(byte: number, garbled = false): void {\n    if (this.silent) {\n      return;\n    }\n\n    if (this.corruptNextEcho) {\n      this.corruptNextEcho = false;\n      this.#output.push(byte ^ 0xff);\n    } else {\n      this.#output.push(garbled ? byte ^ 0xff : byte);\n    }\n  }\n\n  #receive(byte: number): void {\n    const now = Date.now();\n\n    // Like the firmware, drop a half-received command after a long enough\n    // silence. The address already latched is kept.\n    if (\n      this.#state !== 'idle' &&\n      now - this.#lastByteAt + this.#quietMs >= this.commandTimeoutMs\n    ) {\n      this.#state = 'idle';\n    }\n\n    this.#lastByteAt = now;\n    this.#quietMs = 0;\n\n    if (this.#state === 'writeValue') {\n      this.memory[this.#writeAddr] = byte;\n\n      if (!this.#failingWrite) {\n        this.#memoryWritesDone += 1;\n        this.#echo(byte);\n      } else if (this.memoryWriteFault !== 'valueEchoLost') {\n        this.#echo(byte, this.memoryWriteFault === 'valueEchoCorrupted');\n      }\n\n      this.#state = 'idle';\n      this.#latched = false;\n\n      return;\n    }\n\n    if (this.#state === 'coarse2') {\n      this.#coarse = ((this.#firstCoarse & 0x03) << 14) | (byte << 6);\n      this.#lengthCode = (this.#firstCoarse >> 2) & 0x1f;\n      this.#echo(byte);\n      this.#state = 'idle';\n      this.#latched = true;\n\n      return;\n    }\n\n    if (byte < 0x80) {\n      this.#firstCoarse = byte;\n      this.#echo(byte);\n      this.#state = 'coarse2';\n      this.#latched = false;\n    } else if (!this.#latched) {\n      // A command byte without a preceding coarse address is ignored.\n    } else if ((byte & 0xc0) === 0xc0) {\n      this.#streamRead(this.#coarse | (byte & 0x3f));\n    } else {\n      this.#failingWrite = this.#memoryWriteFails();\n\n      if (this.#failingWrite && this.memoryWriteFault === 'commandLost') {\n        return;\n      }\n\n      this.#writeAddr = this.#coarse | (byte & 0x3f);\n      this.#echo(\n        byte,\n        this.#failingWrite && this.memoryWriteFault === 'commandEchoCorrupted',\n      );\n      this.#state = 'writeValue';\n    }\n  }\n\n  #memoryWriteFails(): boolean {\n    return (\n      this.#failMemoryWritesAfter !== undefined &&\n      this.#memoryWritesDone >= this.#failMemoryWritesAfter\n    );\n  }\n\n  #streamRead(address: number): void {\n    if (this.silent) {\n      return;\n    }\n\n    let length = lengthFromCode(this.#lengthCode) ?? 0;\n\n    if (this.streamLimit !== undefined) {\n      length = Math.min(length, this.streamLimit);\n    }\n\n    for (let i = 0; i < length; i++) {\n      this.#output.push(this.memory[(address + i) % MEMORY_SIZE] ?? 0);\n    }\n  }\n}\n"]}

package/dist/version.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: GPL-3.0-only
 // Copyright (C) 2026 comm14cux-ts contributors
 /** Updated by release-please; must match `version` in package.json (enforced by a test). */
-const PACKAGE_VERSION = '0.2.0'; // x-release-please-version
+const PACKAGE_VERSION = '0.2.1'; // x-release-please-version
 const [major = 0, minor = 0, patch = 0] = PACKAGE_VERSION.split('.').map(Number);
 export /**
  *

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,+CAA+C;AAkB/C,4FAA4F;AAC5F,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,2BAA2B;AAE5D,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GACrC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAEzC,MAAM,CAAC;;GAEJ,CACH,MAAM,eAAe,GAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Copyright (C) 2026 comm14cux-ts contributors\n\n/** Major/minor/patch version of this library (`c14cux_version`). */\nexport interface Version {\n  /**\n   * Major version number.\n   */\n  major: number;\n  /**\n   * Minor version number.\n   */\n  minor: number;\n  /**\n   * Patch version number.\n   */\n  patch: number;\n}\n\n/** Updated by release-please; must match `version` in package.json (enforced by a test). */\nconst PACKAGE_VERSION = '0.2.0'; // x-release-please-version\n\nconst [major = 0, minor = 0, patch = 0] =\n  PACKAGE_VERSION.split('.').map(Number);\n\nexport /**\n *\n */\nconst LIBRARY_VERSION: Version = { major, minor, patch };\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,+CAA+C;AAkB/C,4FAA4F;AAC5F,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,2BAA2B;AAE5D,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GACrC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAEzC,MAAM,CAAC;;GAEJ,CACH,MAAM,eAAe,GAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Copyright (C) 2026 comm14cux-ts contributors\n\n/** Major/minor/patch version of this library (`c14cux_version`). */\nexport interface Version {\n  /**\n   * Major version number.\n   */\n  major: number;\n  /**\n   * Minor version number.\n   */\n  minor: number;\n  /**\n   * Patch version number.\n   */\n  patch: number;\n}\n\n/** Updated by release-please; must match `version` in package.json (enforced by a test). */\nconst PACKAGE_VERSION = '0.2.1'; // x-release-please-version\n\nconst [major = 0, minor = 0, patch = 0] =\n  PACKAGE_VERSION.split('.').map(Number);\n\nexport /**\n *\n */\nconst LIBRARY_VERSION: Version = { major, minor, patch };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kb1rma/libcomm14cux-ts",
-	"version": "0.2.0-beta.7",
+	"version": "0.2.1-beta.9",
 	"description": "TypeScript library for communicating with the Lucas 14CUX engine ECU over a serial port using the Web Serial API",
 	"license": "GPL-3.0-only",
 	"repository": {

package/src/constants.ts

@@ -173,3 +173,10 @@ export type PurgeValveState =
 
 /** Default per-read silence timeout, matching libcomm14cux (100 ms). */
 export const DEFAULT_READ_TIMEOUT_MS = 100;
+
+/**
+ * Default quiet time after a failed command (500 ms). The ECU drops a
+ * half-received command after 256 passes of its main loop with nothing
+ * received; this is a conservative estimate of how long that takes.
+ */
+export const DEFAULT_COMMAND_RESET_MS = 500;

package/src/ecu.ts

@@ -9,6 +9,7 @@ import {
   Bank,
   DataOffsetRev,
   DataSize,
+  DEFAULT_COMMAND_RESET_MS,
   DEFAULT_READ_TIMEOUT_MS,
   FUEL_MAP_COLUMNS,
   MemoryOffset,
@@ -76,6 +77,15 @@ export interface EcuOptions {
    * libcomm14cux.
    */
   readTimeoutMs?: number;
+  /**
+   * After a command fails part-way, the ECU may still be waiting for the rest
+   * of it, and would take the next byte sent as that rest (for a write, as the
+   * value to store). So before the next command, the `Ecu` waits until the
+   * line has been quiet this long, in milliseconds, discarding anything that
+   * arrives late. It should exceed the time the ECU takes to drop a
+   * half-received command. Defaults to 500.
+   */
+  commandResetMs?: number;
 }
 
 /**
@@ -147,6 +157,7 @@ export class Ecu {
     this.#protocol = new Protocol(
       transport,
       options.readTimeoutMs ?? DEFAULT_READ_TIMEOUT_MS,
+      options.commandResetMs ?? DEFAULT_COMMAND_RESET_MS,
     );
   }
 

package/src/index.ts

@@ -6,6 +6,7 @@ export * from './constants.js';
 export * from './errors.js';
 export type { Transport } from './transport/types.js';
 export { SimulatedTransport } from './transport/simulated.js';
+export type { MemoryWriteFault } from './transport/simulated.js';
 export {
   WebSerialTransport,
   type WebSerialTransportOptions,

package/src/protocol/protocol.ts

@@ -2,8 +2,11 @@
 // Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)
 // Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.
 // Ported to TypeScript and modified for comm14cux-ts, 2026.
-import { DEFAULT_READ_TIMEOUT_MS } from '../constants.js';
-import { ProtocolError, ReadCancelledError } from '../errors.js';
+import {
+  DEFAULT_COMMAND_RESET_MS,
+  DEFAULT_READ_TIMEOUT_MS,
+} from '../constants.js';
+import { ProtocolError, ReadCancelledError, TimeoutError } from '../errors.js';
 import type { Transport } from '../transport/types.js';
 import { nextRead } from './readCount.js';
 
@@ -11,6 +14,9 @@ const ADDRESS_SPACE = 0x10000;
 const COARSE_WINDOW = 64;
 // Writes use the coarse-address command with a length code of 0.
 const WRITE_LENGTH_CODE = 0;
+// The longest the ECU can keep talking after a failed command: a whole
+// 512-byte read reply, plus a few echoes.
+const MAX_LATE_BYTES = 0x200 + 4;
 
 /**
  * Memory read and write commands over a `Transport`
@@ -23,6 +29,8 @@ const WRITE_LENGTH_CODE = 0;
 export class Protocol {
   readonly #transport: Transport;
   readonly #timeoutMs: number;
+  readonly #commandResetMs: number;
+  #resyncNeeded = false;
   #lastReadCoarseAddress = 0;
   #lastReadQuantity = 0;
 
@@ -31,10 +39,17 @@ export class Protocol {
    *
    * @param transport - The link to the ECU.
    * @param timeoutMs - Silence timeout for each read, in milliseconds.
+   * @param commandResetMs - Quiet time to wait for after a failed command,
+   * in milliseconds.
    */
-  constructor(transport: Transport, timeoutMs = DEFAULT_READ_TIMEOUT_MS) {
+  constructor(
+    transport: Transport,
+    timeoutMs = DEFAULT_READ_TIMEOUT_MS,
+    commandResetMs = DEFAULT_COMMAND_RESET_MS,
+  ) {
     this.#transport = transport;
     this.#timeoutMs = timeoutMs;
+    this.#commandResetMs = commandResetMs;
   }
 
   /** Forgets the last coarse address, forcing the next read to set it. */
@@ -74,6 +89,8 @@ export class Protocol {
     let totalRead = 0;
 
     try {
+      await this.#resync();
+
       while (totalRead < length) {
         if (multiChunk && isCancelled()) {
           throw new ReadCancelledError('Read cancelled');
@@ -105,6 +122,8 @@ export class Protocol {
       }
     } catch (error) {
       this.resetCache();
+      // Cancellation happens between chunks, when the ECU is idle.
+      this.#resyncNeeded ||= !(error instanceof ReadCancelledError);
       throw error;
     }
 
@@ -128,9 +147,16 @@ export class Protocol {
     }
 
     this.resetCache();
-    await this.setCoarseAddr(addr, WRITE_LENGTH_CODE);
-    await this.#sendEchoed(0x80 | (addr & 0x3f));
-    await this.#sendEchoed(value);
+
+    try {
+      await this.#resync();
+      await this.setCoarseAddr(addr, WRITE_LENGTH_CODE);
+      await this.#sendEchoed(0x80 | (addr & 0x3f));
+      await this.#sendEchoed(value);
+    } catch (error) {
+      this.#resyncNeeded = true;
+      throw error;
+    }
   }
 
   /**
@@ -147,6 +173,36 @@ export class Protocol {
     await this.#sendEchoed((addr >> 6) & 0xff);
   }
 
+  /**
+   * After a failed command the ECU may still be waiting for the rest of it,
+   * and would take the next byte sent as that rest: for a write, as the value
+   * to store. Waits until the line has been quiet long enough for the ECU to
+   * drop the half-received command, discarding any late bytes.
+   *
+   * @throws {@link ProtocolError} if the ECU never goes quiet.
+   */
+  async #resync(): Promise<void> {
+    if (!this.#resyncNeeded) {
+      return;
+    }
+
+    for (let i = 0; i <= MAX_LATE_BYTES; i++) {
+      try {
+        await this.#transport.read(1, this.#commandResetMs);
+      } catch (error) {
+        if (!(error instanceof TimeoutError)) {
+          throw error;
+        }
+
+        this.#resyncNeeded = false;
+
+        return;
+      }
+    }
+
+    throw new ProtocolError('ECU did not go quiet after a failed command');
+  }
+
   async #sendEchoed(byte: number): Promise<void> {
     await this.#transport.write(Uint8Array.of(byte));
 

package/src/transport/simulated.ts

@@ -10,6 +10,31 @@ const MEMORY_SIZE = 0x10000;
 
 type State = 'idle' | 'coarse2' | 'writeValue';
 
+/**
+ * Where a memory write injected by {@link SimulatedTransport.failMemoryWritesAfter}
+ * goes wrong:
+ *
+ * - `'commandLost'`: the write command never reaches the ECU. No echo, and
+ *   nothing is stored.
+ * - `'commandEchoCorrupted'`: the ECU takes the write command, but its echo
+ *   is garbled on the way back. The ECU then waits for the value byte.
+ * - `'valueEchoLost'`: the ECU stores the value, but its echo is lost.
+ * - `'valueEchoCorrupted'`: the ECU stores the value, but its echo is garbled
+ *   on the way back.
+ */
+export type MemoryWriteFault =
+  | 'commandLost'
+  | 'commandEchoCorrupted'
+  | 'valueEchoLost'
+  | 'valueEchoCorrupted';
+
+/**
+ * How long the simulated ECU waits, with nothing received, before it drops a
+ * half-received command. The real firmware does this after 256 passes of its
+ * main loop; the time that takes is not documented and varies with load.
+ */
+const SIMULATED_COMMAND_TIMEOUT_MS = 250;
+
 function lengthFromCode(code: number): number | undefined {
   if (code <= 0x0f) {
     return code + 1;
@@ -45,6 +70,18 @@ export class SimulatedTransport implements Transport {
   silent = false;
   /** Fault injection: reject every write. */
   failWrites = false;
+  /**
+   * Fault injection: where a write failed by
+   * {@link SimulatedTransport.failMemoryWritesAfter} goes wrong. Defaults to
+   * `'commandLost'`.
+   */
+  memoryWriteFault: MemoryWriteFault = 'commandLost';
+  /**
+   * How long the ECU waits, with nothing received, before it drops a
+   * half-received command, in milliseconds. A read that times out counts as
+   * that much silence.
+   */
+  commandTimeoutMs = SIMULATED_COMMAND_TIMEOUT_MS;
   /** Fault injection: stream at most this many bytes per read command. */
   streamLimit: number | undefined = undefined;
 
@@ -56,6 +93,32 @@ export class SimulatedTransport implements Transport {
   #latched = false;
   #lengthCode = 0;
   #writeAddr = 0;
+  #failMemoryWritesAfter: number | undefined = undefined;
+  #memoryWritesDone = 0;
+  #failingWrite = false;
+  #lastByteAt = 0;
+  #quietMs = 0;
+
+  /**
+   * Fault injection: let this many memory writes succeed, then fail every
+   * later one, while reads keep working. `undefined` (the default) never
+   * fails; `0` fails the first. Setting it starts the count again.
+   *
+   * @returns The number of memory writes allowed to succeed.
+   */
+  get failMemoryWritesAfter(): number | undefined {
+    return this.#failMemoryWritesAfter;
+  }
+
+  /**
+   * Sets the memory-write fault limit and starts the count again.
+   *
+   * @param count - Memory writes to allow before failing, or `undefined` for none.
+   */
+  set failMemoryWritesAfter(count: number | undefined) {
+    this.#failMemoryWritesAfter = count;
+    this.#memoryWritesDone = 0;
+  }
 
   /**
    * Whether the transport is open.
@@ -134,18 +197,20 @@ export class SimulatedTransport implements Transport {
    * Takes bytes from the simulated ECU's reply.
    *
    * @param length - Number of bytes wanted.
-   * @param _timeoutMs - Ignored; the simulation answers immediately.
+   * @param timeoutMs - The simulation answers at once, but a read that times
+   * out counts as this much silence on the line.
    * @returns Exactly `length` bytes.
    * @throws {@link TimeoutError} if the ECU has not produced that many bytes.
    * @throws {@link NotConnectedError} if the transport is closed.
    */
-  read(length: number, _timeoutMs: number): Promise<Uint8Array> {
+  read(length: number, timeoutMs: number): Promise<Uint8Array> {
     if (!this.#open) {
       return Promise.reject(new NotConnectedError('Transport is not open'));
     }
 
     if (this.#output.length < length) {
       this.#output = [];
+      this.#quietMs += timeoutMs;
 
       return Promise.reject(new TimeoutError('Simulated ECU is silent'));
     }
@@ -153,7 +218,7 @@ export class SimulatedTransport implements Transport {
     return Promise.resolve(Uint8Array.from(this.#output.splice(0, length)));
   }
 
-  #echo(byte: number): void {
+  #echo(byte: number, garbled = false): void {
     if (this.silent) {
       return;
     }
@@ -162,14 +227,35 @@ export class SimulatedTransport implements Transport {
       this.corruptNextEcho = false;
       this.#output.push(byte ^ 0xff);
     } else {
-      this.#output.push(byte);
+      this.#output.push(garbled ? byte ^ 0xff : byte);
     }
   }
 
   #receive(byte: number): void {
+    const now = Date.now();
+
+    // Like the firmware, drop a half-received command after a long enough
+    // silence. The address already latched is kept.
+    if (
+      this.#state !== 'idle' &&
+      now - this.#lastByteAt + this.#quietMs >= this.commandTimeoutMs
+    ) {
+      this.#state = 'idle';
+    }
+
+    this.#lastByteAt = now;
+    this.#quietMs = 0;
+
     if (this.#state === 'writeValue') {
       this.memory[this.#writeAddr] = byte;
-      this.#echo(byte);
+
+      if (!this.#failingWrite) {
+        this.#memoryWritesDone += 1;
+        this.#echo(byte);
+      } else if (this.memoryWriteFault !== 'valueEchoLost') {
+        this.#echo(byte, this.memoryWriteFault === 'valueEchoCorrupted');
+      }
+
       this.#state = 'idle';
       this.#latched = false;
 
@@ -196,12 +282,28 @@ export class SimulatedTransport implements Transport {
     } else if ((byte & 0xc0) === 0xc0) {
       this.#streamRead(this.#coarse | (byte & 0x3f));
     } else {
+      this.#failingWrite = this.#memoryWriteFails();
+
+      if (this.#failingWrite && this.memoryWriteFault === 'commandLost') {
+        return;
+      }
+
       this.#writeAddr = this.#coarse | (byte & 0x3f);
-      this.#echo(byte);
+      this.#echo(
+        byte,
+        this.#failingWrite && this.memoryWriteFault === 'commandEchoCorrupted',
+      );
       this.#state = 'writeValue';
     }
   }
 
+  #memoryWriteFails(): boolean {
+    return (
+      this.#failMemoryWritesAfter !== undefined &&
+      this.#memoryWritesDone >= this.#failMemoryWritesAfter
+    );
+  }
+
   #streamRead(address: number): void {
     if (this.silent) {
       return;