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

package/dist/src/discovery/constants.js

@@ -0,0 +1,45 @@
+/**
+ * Standard Modbus baud rates for thorough scanning
+ * Ordered by commonality (most common first)
+ */
+export const STANDARD_BAUD_RATES = [
+    9600, // Most common
+    19200, // Modbus spec default
+    14400,
+    38400,
+    57600,
+    115200,
+    4800, // Less common
+    2400, // Legacy
+];
+/**
+ * Common baud rates for quick scanning
+ */
+export const COMMON_BAUD_RATES = [9600, 19200];
+/**
+ * Standard Modbus parity settings
+ * Ordered by commonality
+ */
+export const STANDARD_PARITY = ['none', 'even', 'odd'];
+/**
+ * Standard data bits options
+ */
+export const STANDARD_DATA_BITS = [8, 7];
+/**
+ * Common data bits for quick scanning
+ */
+export const COMMON_DATA_BITS = [8];
+/**
+ * Standard stop bits options
+ */
+export const STANDARD_STOP_BITS = [1, 2];
+/**
+ * Common stop bits for quick scanning
+ */
+export const COMMON_STOP_BITS = [1];
+/**
+ * Valid Modbus slave address range (0 is broadcast, 248-255 reserved)
+ */
+export const MIN_SLAVE_ID = 1;
+export const MAX_SLAVE_ID = 247;
+//# sourceMappingURL=constants.js.map

package/dist/src/discovery/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/discovery/constants.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwB;IACtD,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,sBAAsB;IAC7B,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,SAAS;CACP,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB,CAAC,IAAI,EAAE,KAAK,CAAU,CAAA;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAA;AAElF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,CAAC,CAAC,EAAE,CAAC,CAAU,CAAA;AAEtE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,CAAC,CAAC,CAAU,CAAA;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,CAAC,CAAC,EAAE,CAAC,CAAU,CAAA;AAEtE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,CAAC,CAAC,CAAU,CAAA;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA"}

package/dist/src/discovery/device-identifier.d.ts

@@ -0,0 +1,52 @@
+import type ModbusRTU from 'modbus-serial';
+/**
+ * Device identification result from discovery attempt
+ * Provides comprehensive information about device presence and capabilities
+ */
+export interface DeviceIdentificationResult {
+    /** Whether a Modbus device is present at this address/configuration */
+    present: boolean;
+    /** Response time in milliseconds */
+    responseTimeMs: number;
+    /** Vendor/manufacturer name (from FC43) */
+    vendorName?: string;
+    /** Product code/identifier (from FC43) */
+    productCode?: string;
+    /** Model name (from FC43) */
+    modelName?: string;
+    /** Firmware/hardware revision (from FC43) */
+    revision?: string;
+    /** Whether device supports FC43 (Read Device Identification) */
+    supportsFC43?: boolean;
+    /** Device present but returned Modbus exception code */
+    exceptionCode?: number;
+    /** Request timed out (no response) */
+    timeout?: boolean;
+    /** CRC check failed (wrong serial parameters) */
+    crcError?: boolean;
+}
+/**
+ * Attempt to identify a Modbus device at the current client configuration
+ *
+ * Uses FC43 (Read Device Identification) to probe for device presence.
+ * Any Modbus response (including exceptions) indicates a device is present.
+ * Only timeouts and CRC errors mean no device with these parameters.
+ *
+ * @param client - Configured ModbusRTU client (address, serial params, and timeout already set)
+ * @returns Device identification result
+ *
+ * @example
+ * ```typescript
+ * const client = new ModbusRTU()
+ * await client.connectRTUBuffered('/dev/ttyUSB0', { baudRate: 9600 })
+ * client.setID(1)
+ * client.setTimeout(1000)
+ *
+ * const result = await identifyDevice(client)
+ * if (result.present) {
+ *   console.log(`Found device: ${result.vendorName ?? 'Unknown'}`)
+ * }
+ * ```
+ */
+export declare function identifyDevice(client: ModbusRTU): Promise<DeviceIdentificationResult>;
+//# sourceMappingURL=device-identifier.d.ts.map

package/dist/src/discovery/device-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-identifier.d.ts","sourceRoot":"","sources":["../../../src/discovery/device-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,eAAe,CAAA;AAsC1C;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAEhB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAA;IAGtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;IAGjB,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAA;IAGtB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAgID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAgC3F"}

package/dist/src/discovery/device-identifier.js

@@ -0,0 +1,193 @@
+/**
+ * FC43 Read Device ID Code values (MEI type)
+ * See Modbus specification 6.21 - Read Device Identification (FC43/0x2B)
+ */
+const FC43_READ_DEVICE_ID_CODE = {
+    /** Basic device identification (VendorName, ProductCode, Revision) */
+    BASIC: 1,
+    /** Regular device identification (adds additional standard objects) */
+    REGULAR: 2,
+    /** Extended device identification (includes vendor-specific objects) */
+    EXTENDED: 3,
+    /** Specific individual object request */
+    SPECIFIC: 4,
+};
+/**
+ * FC43 Object ID values for device identification
+ * See Modbus specification 6.21 - Read Device Identification object IDs
+ */
+const FC43_OBJECT_ID = {
+    /** Vendor/manufacturer name */
+    VENDOR_NAME: 0,
+    /** Product code/identifier */
+    PRODUCT_CODE: 1,
+    /** Major/minor revision number */
+    MAJOR_MINOR_REVISION: 2,
+    /** Vendor URL */
+    VENDOR_URL: 3,
+    /** Product name/model */
+    PRODUCT_NAME: 4,
+    /** Model name */
+    MODEL_NAME: 5,
+    /** User application name */
+    USER_APPLICATION_NAME: 6,
+};
+/**
+ * Check if error is a Modbus exception (device present but unsupported function/address)
+ */
+function isModbusException(error) {
+    if (error && typeof error === 'object' && 'modbusCode' in error) {
+        const code = error.modbusCode;
+        return typeof code === 'number' ? code : undefined;
+    }
+    return undefined;
+}
+/**
+ * Check if error is a timeout (device not responding)
+ *
+ * The modbus-serial library can return timeout errors in different formats:
+ * - Error with message containing "timeout" (most common)
+ * - Error with errno='ETIMEDOUT' (serial port timeout)
+ * - Error with code='ETIMEDOUT' (TCP socket timeout)
+ *
+ * We check all three formats to handle different error sources reliably.
+ */
+function isTimeout(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const err = error;
+    return Boolean((err.message?.toLowerCase().includes('timeout') ?? false) ||
+        err.errno === 'ETIMEDOUT' ||
+        err.code === 'ETIMEDOUT');
+}
+/**
+ * Check if error is a CRC error (wrong serial parameters)
+ *
+ * The modbus-serial library can return CRC errors in different formats:
+ * - Error with message containing "crc" (most common, e.g., "CRC error")
+ * - Error with errno='CRC' (serial port CRC validation failure)
+ *
+ * CRC errors indicate wrong serial parameters (baud rate, parity, etc.)
+ * and are distinguished from timeouts to guide parameter tuning.
+ */
+function isCRCError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const err = error;
+    return Boolean((err.message?.toLowerCase().includes('crc') ?? false) || err.errno === 'CRC');
+}
+/**
+ * Try to identify device using FC43 (Read Device Identification)
+ *
+ * FC43/14 is the standard MEI (Modbus Encapsulated Interface) for device identification.
+ * Not all devices support this - device-level support is handled via exception codes.
+ *
+ * Any Modbus response (including exceptions) indicates a device is present.
+ * Throws for timeout/CRC errors which indicate no device with these parameters.
+ *
+ * @param client - Configured ModbusRTU client
+ * @param startTime - Start time for response time calculation
+ * @throws Error for timeout, CRC, or other communication failures
+ * @returns DeviceIdentificationResult with present: true guaranteed
+ */
+async function tryFC43(client, startTime) {
+    try {
+        const response = await client.readDeviceIdentification(FC43_READ_DEVICE_ID_CODE.BASIC, FC43_OBJECT_ID.VENDOR_NAME);
+        // Build result object with response time
+        const result = {
+            present: true,
+            responseTimeMs: performance.now() - startTime,
+            supportsFC43: true,
+        };
+        // modbus-serial returns { data: { 0: "vendor", 1: "product", 2: "revision" }, conformityLevel }
+        if (response.data && typeof response.data === 'object') {
+            const data = response.data;
+            const vendorName = data[FC43_OBJECT_ID.VENDOR_NAME];
+            if (vendorName !== undefined) {
+                result.vendorName = vendorName;
+            }
+            const productCode = data[FC43_OBJECT_ID.PRODUCT_CODE];
+            if (productCode !== undefined) {
+                result.productCode = productCode;
+            }
+            const revision = data[FC43_OBJECT_ID.MAJOR_MINOR_REVISION];
+            if (revision !== undefined) {
+                result.revision = revision;
+            }
+            // Note: modelName requires requesting FC43_OBJECT_ID.MODEL_NAME specifically
+        }
+        return result;
+    }
+    catch (error) {
+        const responseTime = performance.now() - startTime;
+        const exceptionCode = isModbusException(error);
+        if (exceptionCode !== undefined) {
+            // Exception means device is present but doesn't support FC43 or the specific registers
+            // This is still a successful device detection - we found a device, just don't know what it is
+            return {
+                present: true,
+                responseTimeMs: responseTime,
+                supportsFC43: false,
+                exceptionCode,
+            };
+        }
+        // Timeout, CRC, or other communication error - let caller handle it
+        throw error;
+    }
+}
+/**
+ * Attempt to identify a Modbus device at the current client configuration
+ *
+ * Uses FC43 (Read Device Identification) to probe for device presence.
+ * Any Modbus response (including exceptions) indicates a device is present.
+ * Only timeouts and CRC errors mean no device with these parameters.
+ *
+ * @param client - Configured ModbusRTU client (address, serial params, and timeout already set)
+ * @returns Device identification result
+ *
+ * @example
+ * ```typescript
+ * const client = new ModbusRTU()
+ * await client.connectRTUBuffered('/dev/ttyUSB0', { baudRate: 9600 })
+ * client.setID(1)
+ * client.setTimeout(1000)
+ *
+ * const result = await identifyDevice(client)
+ * if (result.present) {
+ *   console.log(`Found device: ${result.vendorName ?? 'Unknown'}`)
+ * }
+ * ```
+ */
+export async function identifyDevice(client) {
+    const startTime = performance.now();
+    try {
+        // Try FC43 (provides device identification)
+        return await tryFC43(client, startTime);
+    }
+    catch (error) {
+        // Communication error - classify and return appropriate result
+        const responseTime = performance.now() - startTime;
+        if (isTimeout(error)) {
+            return {
+                present: false,
+                timeout: true,
+                responseTimeMs: responseTime,
+            };
+        }
+        if (isCRCError(error)) {
+            return {
+                present: false,
+                crcError: true,
+                responseTimeMs: responseTime,
+            };
+        }
+        // Other error (network, etc.) - treat as not present
+        return {
+            present: false,
+            responseTimeMs: responseTime,
+        };
+    }
+}
+//# sourceMappingURL=device-identifier.js.map

package/dist/src/discovery/device-identifier.js.map

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

package/dist/src/discovery/parameter-generator-utils.d.ts

@@ -0,0 +1,29 @@
+import type { BaudRate, DataBits, Parity, StopBits, SupportedSerialConfig } from '@ya-modbus/driver-types';
+import type { DiscoveryStrategy, GeneratorOptions } from './parameter-generator.js';
+/**
+ * Get parameter arrays based on strategy and configuration
+ */
+export declare function getParameterArrays(strategy: DiscoveryStrategy, supportedConfig?: SupportedSerialConfig): {
+    baudRates: readonly BaudRate[];
+    parities: readonly Parity[];
+    dataBits: readonly DataBits[];
+    stopBits: readonly StopBits[];
+    addressRange: readonly [number, number];
+};
+/**
+ * Count the total number of parameter combinations without materializing them
+ *
+ * This is much more efficient than Array.from(generateParameterCombinations()).length
+ * as it calculates the count mathematically instead of generating all combinations.
+ *
+ * @param options - Generator options
+ * @returns Total number of combinations that will be generated
+ *
+ * @example
+ * ```typescript
+ * const count = countParameterCombinations({ strategy: 'quick' })
+ * console.log(`Will test ${count} combinations`) // Will test 3952 combinations
+ * ```
+ */
+export declare function countParameterCombinations(options: GeneratorOptions): number;
+//# sourceMappingURL=parameter-generator-utils.d.ts.map

package/dist/src/discovery/parameter-generator-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-generator-utils.d.ts","sourceRoot":"","sources":["../../../src/discovery/parameter-generator-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,qBAAqB,EACtB,MAAM,yBAAyB,CAAA;AAahC,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEnF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,eAAe,CAAC,EAAE,qBAAqB,GACtC;IACD,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC7B,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC7B,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC,CA+BA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAc5E"}

package/dist/src/discovery/parameter-generator-utils.js

@@ -0,0 +1,59 @@
+import { COMMON_BAUD_RATES, COMMON_DATA_BITS, COMMON_STOP_BITS, MAX_SLAVE_ID, MIN_SLAVE_ID, STANDARD_BAUD_RATES, STANDARD_DATA_BITS, STANDARD_PARITY, STANDARD_STOP_BITS, } from './constants.js';
+/**
+ * Get parameter arrays based on strategy and configuration
+ */
+export function getParameterArrays(strategy, supportedConfig) {
+    if (strategy === 'quick' && supportedConfig) {
+        // Quick mode with driver config: use supported values or fall back to common
+        return {
+            baudRates: supportedConfig.validBaudRates ?? COMMON_BAUD_RATES,
+            parities: supportedConfig.validParity ?? STANDARD_PARITY,
+            dataBits: supportedConfig.validDataBits ?? STANDARD_DATA_BITS,
+            stopBits: supportedConfig.validStopBits ?? STANDARD_STOP_BITS,
+            addressRange: supportedConfig.validAddressRange ?? [MIN_SLAVE_ID, MAX_SLAVE_ID],
+        };
+    }
+    if (strategy === 'thorough') {
+        // Thorough mode: use supported config if provided, otherwise standard Modbus
+        return {
+            baudRates: supportedConfig?.validBaudRates ?? STANDARD_BAUD_RATES,
+            parities: supportedConfig?.validParity ?? STANDARD_PARITY,
+            dataBits: supportedConfig?.validDataBits ?? STANDARD_DATA_BITS,
+            stopBits: supportedConfig?.validStopBits ?? STANDARD_STOP_BITS,
+            addressRange: supportedConfig?.validAddressRange ?? [MIN_SLAVE_ID, MAX_SLAVE_ID],
+        };
+    }
+    // Quick mode without driver config: use common parameters
+    return {
+        baudRates: COMMON_BAUD_RATES,
+        parities: STANDARD_PARITY,
+        dataBits: COMMON_DATA_BITS,
+        stopBits: COMMON_STOP_BITS,
+        addressRange: [MIN_SLAVE_ID, MAX_SLAVE_ID],
+    };
+}
+/**
+ * Count the total number of parameter combinations without materializing them
+ *
+ * This is much more efficient than Array.from(generateParameterCombinations()).length
+ * as it calculates the count mathematically instead of generating all combinations.
+ *
+ * @param options - Generator options
+ * @returns Total number of combinations that will be generated
+ *
+ * @example
+ * ```typescript
+ * const count = countParameterCombinations({ strategy: 'quick' })
+ * console.log(`Will test ${count} combinations`) // Will test 3952 combinations
+ * ```
+ */
+export function countParameterCombinations(options) {
+    const { strategy, supportedConfig } = options;
+    const { baudRates, parities, dataBits, stopBits, addressRange } = getParameterArrays(strategy, supportedConfig);
+    // Calculate address count
+    const [minId, maxId] = addressRange;
+    const addressCount = maxId - minId + 1;
+    // Total combinations = addresses × baud rates × parities × data bits × stop bits
+    return addressCount * baudRates.length * parities.length * dataBits.length * stopBits.length;
+}
+//# sourceMappingURL=parameter-generator-utils.js.map

package/dist/src/discovery/parameter-generator-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-generator-utils.js","sourceRoot":"","sources":["../../../src/discovery/parameter-generator-utils.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAGvB;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,eAAuC;IAQvC,IAAI,QAAQ,KAAK,OAAO,IAAI,eAAe,EAAE,CAAC;QAC5C,6EAA6E;QAC7E,OAAO;YACL,SAAS,EAAE,eAAe,CAAC,cAAc,IAAI,iBAAiB;YAC9D,QAAQ,EAAE,eAAe,CAAC,WAAW,IAAI,eAAe;YACxD,QAAQ,EAAE,eAAe,CAAC,aAAa,IAAI,kBAAkB;YAC7D,QAAQ,EAAE,eAAe,CAAC,aAAa,IAAI,kBAAkB;YAC7D,YAAY,EAAE,eAAe,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;SAChF,CAAA;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,6EAA6E;QAC7E,OAAO;YACL,SAAS,EAAE,eAAe,EAAE,cAAc,IAAI,mBAAmB;YACjE,QAAQ,EAAE,eAAe,EAAE,WAAW,IAAI,eAAe;YACzD,QAAQ,EAAE,eAAe,EAAE,aAAa,IAAI,kBAAkB;YAC9D,QAAQ,EAAE,eAAe,EAAE,aAAa,IAAI,kBAAkB;YAC9D,YAAY,EAAE,eAAe,EAAE,iBAAiB,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;SACjF,CAAA;IACH,CAAC;IAED,0DAA0D;IAC1D,OAAO;QACL,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,gBAAgB;QAC1B,QAAQ,EAAE,gBAAgB;QAC1B,YAAY,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;KAC3C,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAyB;IAClE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAA;IAE7C,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAClF,QAAQ,EACR,eAAe,CAChB,CAAA;IAED,0BAA0B;IAC1B,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,YAAY,CAAA;IACnC,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,CAAC,CAAA;IAEtC,iFAAiF;IACjF,OAAO,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAA;AAC9F,CAAC"}

package/dist/src/discovery/parameter-generator.d.ts

@@ -0,0 +1,97 @@
+import type { BaudRate, DataBits, DefaultSerialConfig, Parity, StopBits, SupportedSerialConfig } from '@ya-modbus/driver-types';
+/**
+ * Parameter combination for discovery testing
+ * Represents a complete set of Modbus RTU serial parameters
+ */
+export interface ParameterCombination {
+    slaveId: number;
+    baudRate: BaudRate;
+    parity: Parity;
+    dataBits: DataBits;
+    stopBits: StopBits;
+}
+/**
+ * Discovery strategy type
+ *
+ * - quick: Tests only driver-supported parameters (5-10 minutes)
+ * - thorough: Tests all standard Modbus parameters (30-60 minutes)
+ */
+export type DiscoveryStrategy = 'quick' | 'thorough';
+/**
+ * Options for parameter combination generation
+ */
+export interface GeneratorOptions {
+    /** Discovery strategy to use */
+    strategy: DiscoveryStrategy;
+    /** Driver-provided default configuration (prioritized first) */
+    defaultConfig?: DefaultSerialConfig;
+    /** Driver-provided supported configuration constraints */
+    supportedConfig?: SupportedSerialConfig;
+}
+/**
+ * Group of parameter combinations that share the same serial configuration
+ */
+export interface ParameterGroup {
+    /** Serial parameters shared by all combinations in this group */
+    serialParams: {
+        baudRate: BaudRate;
+        parity: Parity;
+        dataBits: DataBits;
+        stopBits: StopBits;
+    };
+    /** All parameter combinations for this serial configuration (different slave IDs) */
+    combinations: ParameterCombination[];
+}
+/**
+ * Generate parameter combinations grouped by serial configuration
+ *
+ * This is a memory-efficient alternative to materializing all combinations.
+ * Instead of creating all ~1500+ combinations at once, this generator yields
+ * groups of ~247 combinations at a time (one per serial config).
+ *
+ * Each group shares the same serial parameters (baud, parity, data bits, stop bits)
+ * but has different slave IDs. This matches how the scanner works - it creates
+ * one connection per serial config and tests all slave IDs with that connection.
+ *
+ * @param options - Generation options
+ * @yields Parameter groups to test
+ *
+ * @example Iterate over groups without materializing all combinations
+ * ```typescript
+ * for (const group of generateParameterGroups(options)) {
+ *   // Only this group's ~247 combinations are in memory
+ *   const { serialParams, combinations } = group
+ *   // ... use combinations ...
+ * }
+ * ```
+ */
+export declare function generateParameterGroups(options: GeneratorOptions): Generator<ParameterGroup>;
+/**
+ * Generate all parameter combinations for Modbus device discovery
+ *
+ * Produces combinations in priority order:
+ * 1. Default configuration (if provided) tested first
+ * 2. Common slave addresses (1, 2) before others
+ * 3. Common baud rates before exotic ones
+ *
+ * @param options - Generation options
+ * @yields Parameter combinations to test
+ *
+ * @example Quick discovery with driver config
+ * ```typescript
+ * const combinations = generateParameterCombinations({
+ *   strategy: 'quick',
+ *   defaultConfig: { baudRate: 9600, parity: 'even', ... },
+ *   supportedConfig: { validBaudRates: [9600, 19200], ... }
+ * })
+ * ```
+ *
+ * @example Thorough discovery without driver
+ * ```typescript
+ * const combinations = generateParameterCombinations({
+ *   strategy: 'thorough'
+ * })
+ * ```
+ */
+export declare function generateParameterCombinations(options: GeneratorOptions): Generator<ParameterCombination>;
+//# sourceMappingURL=parameter-generator.d.ts.map

package/dist/src/discovery/parameter-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-generator.d.ts","sourceRoot":"","sources":["../../../src/discovery/parameter-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,qBAAqB,EACtB,MAAM,yBAAyB,CAAA;AAKhC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,QAAQ,EAAE,iBAAiB,CAAA;IAE3B,gEAAgE;IAChE,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAEnC,0DAA0D;IAC1D,eAAe,CAAC,EAAE,qBAAqB,CAAA;CACxC;AAqED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,YAAY,EAAE;QACZ,QAAQ,EAAE,QAAQ,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,QAAQ,CAAA;QAClB,QAAQ,EAAE,QAAQ,CAAA;KACnB,CAAA;IACD,qFAAqF;IACrF,YAAY,EAAE,oBAAoB,EAAE,CAAA;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAiB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAC,cAAc,CAAC,CA8C7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAiB,6BAA6B,CAC5C,OAAO,EAAE,gBAAgB,GACxB,SAAS,CAAC,oBAAoB,CAAC,CAsCjC"}