@ya-modbus/emulator 0.4.1-refactor-scope-driver-packages.0

package/README.md

@@ -0,0 +1,226 @@
+# @ya-modbus/emulator
+
+Software Modbus device emulator for testing device drivers without physical hardware.
+
+## Features
+
+- **Realistic device simulation**: Mimic actual device constraints and timing characteristics
+- **Test acceleration**: Enable fast, deterministic testing without hardware
+- **Edge case coverage**: Simulate error conditions and edge cases
+- **Multiple transports**: TCP, RTU (virtual/real serial ports), and in-memory
+- **Custom function codes**: Support vendor-specific Modbus extensions
+
+## Installation
+
+```bash
+npm install @ya-modbus/emulator
+```
+
+## Quick Start
+
+```typescript
+import { ModbusEmulator } from '@ya-modbus/emulator'
+
+// Create emulator with TCP transport
+const emulator = new ModbusEmulator({
+  transport: 'tcp',
+  port: 5502,
+})
+
+// Add a device
+emulator.addDevice({
+  slaveId: 1,
+  registers: {
+    holding: {
+      0: 230, // Voltage * 10 = 23.0V
+      1: 52, // Current * 10 = 5.2A
+    },
+  },
+})
+
+// Start emulator
+await emulator.start()
+
+// Use with your driver tests
+// ...
+
+// Stop emulator
+await emulator.stop()
+```
+
+## CLI Usage
+
+The emulator can be used from the command line for quick testing:
+
+### Basic Usage
+
+```bash
+# Start with config file
+ya-modbus-emulator --config config.yaml
+
+# Or specify parameters directly
+ya-modbus-emulator --transport rtu --port /dev/ttyUSB0 --slave-id 1
+```
+
+### Command Line Options
+
+```
+Options:
+  -c, --config <file>      Configuration file (YAML or JSON)
+  -t, --transport <type>   Transport type: tcp|rtu|memory
+  -p, --port <port>        TCP port number or serial port path
+  -H, --host <host>        TCP host address (default: 0.0.0.0)
+  -b, --baud-rate <rate>   Serial baud rate (default: 9600)
+  --parity <type>          Serial parity: none|even|odd (default: none)
+  -s, --slave-id <id>      Slave ID (required if no config file)
+  -v, --verbose            Enable verbose logging
+  -q, --quiet              Suppress all output except errors
+  --log-requests           Log all Modbus requests/responses
+  -V, --version            output the version number
+  -h, --help               display help for command
+```
+
+### Configuration Files
+
+Create a YAML or JSON configuration file to define devices and behaviors:
+
+**Basic RTU Example** (`basic-rtu.yaml`):
+
+```yaml
+transport:
+  type: rtu
+  port: /dev/ttyUSB0
+  baudRate: 9600
+  parity: none
+
+devices:
+  - slaveId: 1
+    registers:
+      holding:
+        0: 230 # Voltage * 10 = 23.0V
+        1: 52 # Current * 10 = 5.2A
+```
+
+**Power Meter with Timing** (`power-meter.yaml`):
+
+```yaml
+transport:
+  type: rtu
+  port: /dev/ttyUSB0
+
+devices:
+  - slaveId: 1
+    registers:
+      holding:
+        0: 2300 # Voltage * 10 = 230.0V
+        1: 52 # Current * 10 = 5.2A
+        2: 11960 # Power = 1196W
+    timing:
+      pollingInterval: 10
+      commandDetectionDelay: [3, 8]
+      processingDelay: [2, 5]
+      perRegisterDelay: 0.1
+```
+
+**Multiple Devices** (`multi-device.yaml`):
+
+```yaml
+transport:
+  type: rtu
+  port: /dev/ttyUSB0
+
+devices:
+  - slaveId: 1
+    registers:
+      holding: { 0: 100, 1: 200 }
+  - slaveId: 2
+    registers:
+      holding: { 0: 300, 1: 400 }
+  - slaveId: 3
+    registers:
+      holding: { 0: 500, 1: 600 }
+```
+
+See `examples/config-files/` for more examples.
+
+### Testing with Virtual Serial Ports
+
+> **⚠️ Note**: RTU transport is currently a placeholder for v0.1.0. Serial port communication will be implemented in v0.2.0. Use the memory transport for testing in this version.
+
+For testing without physical hardware, create virtual serial port pairs:
+
+**Linux/macOS** (using socat):
+
+```bash
+# Terminal 1: Create virtual serial port pair
+socat -d -d pty,raw,echo=0 pty,raw,echo=0
+# Note the output: /dev/pts/3 <-> /dev/pts/4
+
+# Terminal 2: Start emulator on first port
+ya-modbus-emulator --transport rtu --port /dev/pts/3 --slave-id 1
+
+# Terminal 3: Run your driver tests against second port
+node test-driver.js --port /dev/pts/4
+```
+
+**Windows** (using com0com):
+
+1. Install [com0com](https://sourceforge.net/projects/com0com/)
+2. Create a pair: COM10 <-> COM11
+3. Start emulator: `ya-modbus-emulator --transport rtu --port COM10 --slave-id 1`
+4. Run tests: `node test-driver.js --port COM11`
+
+See `examples/virtual-serial-test.md` for detailed virtual serial port testing guide.
+
+## Configuration
+
+### Timing Behaviors
+
+Simulate realistic device response times:
+
+```typescript
+emulator.addDevice({
+  slaveId: 1,
+  timing: {
+    pollingInterval: 10, // Device checks for commands every 10ms
+    commandDetectionDelay: [3, 8], // 3-8ms to notice command
+    processingDelay: [2, 5], // 2-5ms to process
+    perRegisterDelay: 0.1, // 0.1ms per register
+  },
+})
+```
+
+### Register Constraints
+
+> **🚧 Planned for v0.2.0**: Define forbidden ranges and batch size limits
+
+```typescript
+// Coming in v0.2.0
+emulator.addDevice({
+  slaveId: 1,
+  constraints: {
+    maxReadRegisters: 80,
+    maxWriteRegisters: 50,
+    forbiddenReadRanges: [{ type: 'holding', start: 100, end: 199, reason: 'Protected' }],
+  },
+})
+```
+
+### Error Simulation
+
+> **🚧 Planned for v0.2.0**: Inject errors for testing error handling
+
+```typescript
+// Coming in v0.2.0
+emulator.addDevice({
+  slaveId: 1,
+  errors: {
+    timeoutProbability: 0.05, // 5% timeout rate
+    crcErrorProbability: 0.01, // 1% CRC error rate
+  },
+})
+```
+
+## License
+
+GPL-3.0-or-later

package/bin/ya-modbus-emulator.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+// Entry point for CLI - delegates to compiled TypeScript
+import { main } from '../dist/cli.js'
+
+// Run the CLI
+main().catch((error) => {
+  console.error('[ERROR]', error instanceof Error ? error.message : String(error))
+  process.exit(1)
+})

package/dist/behaviors/function-codes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Modbus function code handlers
+ */
+import type { EmulatedDevice } from '../device.js';
+export declare const ILLEGAL_FUNCTION = 1;
+export declare const ILLEGAL_DATA_ADDRESS = 2;
+export declare const ILLEGAL_DATA_VALUE = 3;
+/**
+ * Handle a Modbus request and return the response
+ */
+export declare function handleModbusRequest(device: EmulatedDevice, request: Buffer): Buffer;
+//# sourceMappingURL=function-codes.d.ts.map

package/dist/behaviors/function-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-codes.d.ts","sourceRoot":"","sources":["../../src/behaviors/function-codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD,eAAO,MAAM,gBAAgB,IAAO,CAAA;AACpC,eAAO,MAAM,oBAAoB,IAAO,CAAA;AACxC,eAAO,MAAM,kBAAkB,IAAO,CAAA;AAEtC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA4BnF"}

package/dist/behaviors/function-codes.js

@@ -0,0 +1,139 @@
+/**
+ * Modbus function code handlers
+ */
+// Modbus exception codes
+export const ILLEGAL_FUNCTION = 0x01;
+export const ILLEGAL_DATA_ADDRESS = 0x02;
+export const ILLEGAL_DATA_VALUE = 0x03;
+/**
+ * Handle a Modbus request and return the response
+ */
+export function handleModbusRequest(device, request) {
+    if (request.length < 2) {
+        return createExceptionResponse(request[0] ?? 0, 0x00, ILLEGAL_DATA_VALUE);
+    }
+    // Buffer access is safe after length check
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const slaveId = request[0];
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const functionCode = request[1];
+    try {
+        switch (functionCode) {
+            case 0x03:
+                return handleReadHoldingRegisters(device, request);
+            case 0x04:
+                return handleReadInputRegisters(device, request);
+            case 0x06:
+                return handleWriteSingleRegister(device, request);
+            case 0x10:
+                return handleWriteMultipleRegisters(device, request);
+            default:
+                return createExceptionResponse(slaveId, functionCode, ILLEGAL_FUNCTION);
+        }
+    }
+    catch {
+        // If error occurs, return illegal data value exception
+        return createExceptionResponse(slaveId, functionCode, ILLEGAL_DATA_VALUE);
+    }
+}
+/**
+ * 0x03 - Read Holding Registers
+ */
+function handleReadHoldingRegisters(device, request) {
+    if (request.length < 6) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return createExceptionResponse(request[0], 0x03, ILLEGAL_DATA_VALUE);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const slaveId = request[0];
+    const startAddress = request.readUInt16BE(2);
+    const quantity = request.readUInt16BE(4);
+    const byteCount = quantity * 2;
+    const response = Buffer.alloc(3 + byteCount);
+    response[0] = slaveId;
+    response[1] = 0x03;
+    response[2] = byteCount;
+    for (let i = 0; i < quantity; i++) {
+        const value = device.getHoldingRegister(startAddress + i);
+        response.writeUInt16BE(value, 3 + i * 2);
+    }
+    return response;
+}
+/**
+ * 0x04 - Read Input Registers
+ */
+function handleReadInputRegisters(device, request) {
+    if (request.length < 6) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return createExceptionResponse(request[0], 0x04, ILLEGAL_DATA_VALUE);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const slaveId = request[0];
+    const startAddress = request.readUInt16BE(2);
+    const quantity = request.readUInt16BE(4);
+    const byteCount = quantity * 2;
+    const response = Buffer.alloc(3 + byteCount);
+    response[0] = slaveId;
+    response[1] = 0x04;
+    response[2] = byteCount;
+    for (let i = 0; i < quantity; i++) {
+        const value = device.getInputRegister(startAddress + i);
+        response.writeUInt16BE(value, 3 + i * 2);
+    }
+    return response;
+}
+/**
+ * 0x06 - Write Single Register
+ */
+function handleWriteSingleRegister(device, request) {
+    if (request.length < 6) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return createExceptionResponse(request[0], 0x06, ILLEGAL_DATA_VALUE);
+    }
+    const address = request.readUInt16BE(2);
+    const value = request.readUInt16BE(4);
+    device.setHoldingRegister(address, value);
+    // Echo the request as response
+    return request;
+}
+/**
+ * 0x10 - Write Multiple Registers
+ */
+function handleWriteMultipleRegisters(device, request) {
+    if (request.length < 7) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return createExceptionResponse(request[0], 0x10, ILLEGAL_DATA_VALUE);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const slaveId = request[0];
+    const startAddress = request.readUInt16BE(2);
+    const quantity = request.readUInt16BE(4);
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const byteCount = request[6];
+    if (request.length < 7 + byteCount) {
+        return createExceptionResponse(slaveId, 0x10, ILLEGAL_DATA_VALUE);
+    }
+    // Write registers
+    for (let i = 0; i < quantity; i++) {
+        const value = request.readUInt16BE(7 + i * 2);
+        device.setHoldingRegister(startAddress + i, value);
+    }
+    // Response: slave_id + function_code + start_address + quantity
+    const response = Buffer.alloc(6);
+    response[0] = slaveId;
+    response[1] = 0x10;
+    response.writeUInt16BE(startAddress, 2);
+    response.writeUInt16BE(quantity, 4);
+    return response;
+}
+/**
+ * Create a Modbus exception response
+ */
+function createExceptionResponse(slaveId, functionCode, exceptionCode) {
+    const response = Buffer.alloc(3);
+    response[0] = slaveId;
+    response[1] = functionCode | 0x80; // Set error bit
+    response[2] = exceptionCode;
+    return response;
+}
+//# sourceMappingURL=function-codes.js.map

package/dist/behaviors/function-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-codes.js","sourceRoot":"","sources":["../../src/behaviors/function-codes.ts"],"names":[],"mappings":"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"}

package/dist/behaviors/timing.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Timing behavior simulation
+ */
+import type { TimingBehavior } from '../types/config.js';
+/**
+ * Calculate a delay value from a fixed number or random range
+ */
+export declare function calculateDelay(delay: number | [number, number] | undefined): number;
+/**
+ * Calculate transmission delay based on baud rate and frame size
+ * Formula: (frameBytes * 11 bits per byte) / (baudRate / 1000)
+ */
+export declare function calculateTransmissionDelay(frameBytes: number, baudRate: number): number;
+/**
+ * Thin abstraction over setTimeout for dependency injection
+ */
+export interface DelayFunction {
+    (ms: number): Promise<void>;
+}
+/**
+ * Default delay implementation using setTimeout
+ */
+export declare const defaultDelay: DelayFunction;
+/**
+ * Timing simulator that calculates and applies realistic device delays
+ */
+export declare class TimingSimulator {
+    private config;
+    private delayFn;
+    constructor(config: TimingBehavior, delayFn?: DelayFunction);
+    /**
+     * Calculate total delay for a request
+     * @param request - The Modbus request buffer
+     * @param registerCount - Number of registers being accessed
+     * @returns Total delay in milliseconds
+     */
+    calculateTotalDelay(request: Buffer, registerCount: number): number;
+    /**
+     * Apply timing delay for a request
+     * @param request - The Modbus request buffer
+     * @param registerCount - Number of registers being accessed
+     * @returns Promise that resolves after the calculated delay
+     */
+    delay(request: Buffer, registerCount: number): Promise<void>;
+}
+//# sourceMappingURL=timing.d.ts.map

package/dist/behaviors/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/behaviors/timing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAExD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAYnF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,aAK1B,CAAA;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAe;gBAElB,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAA4B;IAKzE;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IA8BnE;;;;;OAKG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAInE"}

package/dist/behaviors/timing.js

@@ -0,0 +1,90 @@
+/**
+ * Timing behavior simulation
+ */
+/**
+ * Calculate a delay value from a fixed number or random range
+ */
+export function calculateDelay(delay) {
+    if (delay === undefined) {
+        return 0;
+    }
+    if (typeof delay === 'number') {
+        return delay;
+    }
+    // Random value in range [min, max]
+    const [min, max] = delay;
+    return min + Math.random() * (max - min);
+}
+/**
+ * Calculate transmission delay based on baud rate and frame size
+ * Formula: (frameBytes * 11 bits per byte) / (baudRate / 1000)
+ */
+export function calculateTransmissionDelay(frameBytes, baudRate) {
+    // Each byte requires 11 bits (1 start + 8 data + 1 parity + 1 stop)
+    const totalBits = frameBytes * 11;
+    // Convert baud rate to bits per millisecond
+    const bitsPerMs = baudRate / 1000;
+    return totalBits / bitsPerMs;
+}
+/**
+ * Default delay implementation using setTimeout
+ */
+export const defaultDelay = (ms) => {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => setTimeout(resolve, ms));
+};
+/**
+ * Timing simulator that calculates and applies realistic device delays
+ */
+export class TimingSimulator {
+    config;
+    delayFn;
+    constructor(config, delayFn = defaultDelay) {
+        this.config = config;
+        this.delayFn = delayFn;
+    }
+    /**
+     * Calculate total delay for a request
+     * @param request - The Modbus request buffer
+     * @param registerCount - Number of registers being accessed
+     * @returns Total delay in milliseconds
+     */
+    calculateTotalDelay(request, registerCount) {
+        let totalDelay = 0;
+        // 1. Command detection delay (or random value in [0, pollingInterval])
+        if (this.config.commandDetectionDelay !== undefined) {
+            totalDelay += calculateDelay(this.config.commandDetectionDelay);
+        }
+        else if (this.config.pollingInterval !== undefined) {
+            // Use random value in range [0, pollingInterval] as detection time
+            totalDelay += calculateDelay([0, this.config.pollingInterval]);
+        }
+        // 2. Processing delay
+        if (this.config.processingDelay !== undefined) {
+            totalDelay += calculateDelay(this.config.processingDelay);
+        }
+        // 3. Per-register delay
+        if (this.config.perRegisterDelay !== undefined) {
+            totalDelay += registerCount * this.config.perRegisterDelay;
+        }
+        // 4. Transmission delay (RTU only, when enabled)
+        if (this.config.autoCalculateTransmissionDelay && this.config.baudRate !== undefined) {
+            const frameSize = request.length;
+            totalDelay += calculateTransmissionDelay(frameSize, this.config.baudRate);
+        }
+        return totalDelay;
+    }
+    /**
+     * Apply timing delay for a request
+     * @param request - The Modbus request buffer
+     * @param registerCount - Number of registers being accessed
+     * @returns Promise that resolves after the calculated delay
+     */
+    async delay(request, registerCount) {
+        const delayMs = this.calculateTotalDelay(request, registerCount);
+        return this.delayFn(delayMs);
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/behaviors/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/behaviors/timing.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * CLI interface for Modbus emulator
+ */
+/**
+ * Main CLI entry point
+ */
+declare function main(): Promise<void>;
+export { main };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AA8CH;;GAEG;AACH,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAmGnC;AAOD,OAAO,EAAE,IAAI,EAAE,CAAA"}