@emdzej/ediabasx-interface-base

Abstract EDIABAS communication interface for the EdiabasX BEST2 interpreter, plus an in-memory simulation interface useful for tests and offline development.

Install

pnpm add @emdzej/ediabasx-interface-base

What it exports

• EdiabasInterface — abstract base class. Concrete interfaces (@emdzej/ediabasx-interface-serial, @emdzej/ediabasx-interface-enet, the JSON-RPC gateway client) extend this. EDIABAS framing on top of a raw wire transport — xsend / xrecv / xsetpar / etc. talk to one of these.
• SimulationInterface — in-memory interface. Register canned responses keyed by the request bytes; send() replays them on the matching request. Lets you run BEST2 jobs without hardware.
• EdiabasTimeoutError — thrown by receive(timeoutMs) when no data arrives in time.

Usage

import { SimulationInterface } from "@emdzej/ediabasx-interface-base";
import { Ediabas } from "@emdzej/ediabasx-ediabas";

const sim = new SimulationInterface();
// Map request bytes → canned response (BMW DS2 telegram including header
// and checksum, just like the wire format).
sim.setResponse([0x12, 0x04, 0x00], [0x12, 0x2e, 0xa0, /* …fault data… */]);

const ediabas = new Ediabas({ ecuPath: "./ecu", interface: sim });
await ediabas.loadSgbd("MS430DS0.prg");
const sets = await ediabas.executeJob("FS_LESEN");

License

PolyForm Noncommercial 1.0.0.