@ya-modbus/transport 0.11.1 → 0.12.0

package/dist/esm/src/index.d.ts

@@ -14,4 +14,5 @@ export { isConnectionLostError, ModbusConnection, type OpenClient } from './conn
 export { TransportManager, type TransportManagerOptions, type TransportStats } from './manager.js';
 export { MutexTransport } from './mutex-transport.js';
 export { SlaveTransport } from './slave-transport.js';
+export { listSerialPorts, matchSerialPorts, type SerialPortInfo, type SerialPortMatch, } from './serial-ports.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAA"}

package/dist/esm/src/index.js

@@ -14,4 +14,5 @@ export { isConnectionLostError, ModbusConnection } from './connection.js';
 export { TransportManager } from './manager.js';
 export { MutexTransport } from './mutex-transport.js';
 export { SlaveTransport } from './slave-transport.js';
+export { listSerialPorts, matchSerialPorts, } from './serial-ports.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAwB,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAoB,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAqD,MAAM,cAAc,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAwB,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,oBAAoB,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAA;AACrF,OAAO,EAAE,oBAAoB,EAAoB,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAmB,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAqD,MAAM,cAAc,CAAA;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EACL,eAAe,EACf,gBAAgB,GAGjB,MAAM,mBAAmB,CAAA"}

package/dist/esm/src/serial-ports.d.ts

@@ -0,0 +1,74 @@
+/**
+ * List serial ports with their USB identity and physical USB port, and select
+ * ports by these values
+ *
+ * USB serial adapters get a new device name when they are plugged in again
+ * (`/dev/ttyUSB0` becomes `/dev/ttyUSB1`). The USB vendor ID, product ID and
+ * serial number identify an adapter. Identical adapters without a serial number
+ * differ only in the physical USB port, which is the name of their link in
+ * `/dev/serial/by-path` (the location).
+ */
+/** A serial port with its USB identity */
+export interface SerialPortInfo {
+    /** Device path, for example `/dev/ttyUSB0` */
+    path: string;
+    /** USB vendor ID as 4 lowercase hex digits, for example `1a86` */
+    vendorId?: string;
+    /** USB product ID as 4 lowercase hex digits, for example `7523` */
+    productId?: string;
+    /** USB serial number, when the adapter has one */
+    serialNumber?: string;
+    /** Manufacturer name, when the adapter has one */
+    manufacturer?: string;
+    /**
+     * Names of the links in `/dev/serial/by-path` to this port, for example
+     * `pci-0000:00:1a.0-usb-0:1.3:1.0-port0`. Newer systemd versions add a
+     * second link (`...-usbv2-...`) for the same USB port. Empty when the port
+     * has no such link (not a USB adapter, or not Linux).
+     */
+    locations: string[];
+}
+/** Values to select ports by. Leave out `serialNumber` or `location` to match any. */
+export interface SerialPortMatch {
+    /** USB vendor ID in hex, for example `1a86` or `0x1A86` */
+    vendorId: string;
+    /** USB product ID in hex, for example `7523` */
+    productId: string;
+    /** USB serial number (case-sensitive) */
+    serialNumber?: string;
+    /** Name of a link in `/dev/serial/by-path`, or the full path of the link */
+    location?: string;
+}
+/** A port as serialport's list or sysfs reports it */
+export interface ListedSerialPort {
+    path: string;
+    vendorId?: string | undefined;
+    productId?: string | undefined;
+    serialNumber?: string | undefined;
+    manufacturer?: string | undefined;
+}
+/** System access of {@link listSerialPorts}, replaced in tests */
+export interface SerialPortsDeps {
+    list: () => Promise<ListedSerialPort[]>;
+    readdir: (path: string) => Promise<string[]>;
+    realpath: (path: string) => Promise<string>;
+    readFile: (path: string) => Promise<string>;
+}
+/**
+ * List the serial ports with their USB identity and locations
+ *
+ * On Linux the ports are read from sysfs (`/sys/class/tty`). This starts no
+ * other program, so it works in a hardened service. Without sysfs (other
+ * systems), the port list of serialport is used (through modbus-serial).
+ *
+ * @param deps - Replacements for the system access, for tests
+ */
+export declare function listSerialPorts(deps?: Partial<SerialPortsDeps>): Promise<SerialPortInfo[]>;
+/**
+ * Select the ports that match all given values
+ *
+ * Returns every match, so the caller can tell a unique match from an
+ * ambiguous one. Ports without a USB vendor or product ID never match.
+ */
+export declare function matchSerialPorts(ports: readonly SerialPortInfo[], match: SerialPortMatch): SerialPortInfo[];
+//# sourceMappingURL=serial-ports.d.ts.map

package/dist/esm/src/serial-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-ports.d.ts","sourceRoot":"","sources":["../../../src/serial-ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACvC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC5C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5C;AAaD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,GAAE,OAAO,CAAC,eAAe,CAAM,GAClC,OAAO,CAAC,cAAc,EAAE,CAAC,CAI3B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,KAAK,EAAE,eAAe,GACrB,cAAc,EAAE,CAelB"}

package/dist/esm/src/serial-ports.js

@@ -0,0 +1,147 @@
+/**
+ * List serial ports with their USB identity and physical USB port, and select
+ * ports by these values
+ *
+ * USB serial adapters get a new device name when they are plugged in again
+ * (`/dev/ttyUSB0` becomes `/dev/ttyUSB1`). The USB vendor ID, product ID and
+ * serial number identify an adapter. Identical adapters without a serial number
+ * differ only in the physical USB port, which is the name of their link in
+ * `/dev/serial/by-path` (the location).
+ */
+import { readdir, readFile, realpath } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import ModbusRTU from 'modbus-serial';
+const BY_PATH_DIR = '/dev/serial/by-path';
+const SYS_TTY_DIR = '/sys/class/tty';
+const systemDeps = {
+    // Loads the optional serialport package only when called
+    list: () => ModbusRTU.getPorts(),
+    readdir: (path) => readdir(path),
+    realpath: (path) => realpath(path),
+    readFile: (path) => readFile(path, 'utf8'),
+};
+/**
+ * List the serial ports with their USB identity and locations
+ *
+ * On Linux the ports are read from sysfs (`/sys/class/tty`). This starts no
+ * other program, so it works in a hardened service. Without sysfs (other
+ * systems), the port list of serialport is used (through modbus-serial).
+ *
+ * @param deps - Replacements for the system access, for tests
+ */
+export async function listSerialPorts(deps = {}) {
+    const system = { ...systemDeps, ...deps };
+    const [ports, locations] = await Promise.all([listPorts(system), readLocations(system)]);
+    return ports.map((port) => toPortInfo(port, locations.get(port.path) ?? []));
+}
+/**
+ * Select the ports that match all given values
+ *
+ * Returns every match, so the caller can tell a unique match from an
+ * ambiguous one. Ports without a USB vendor or product ID never match.
+ */
+export function matchSerialPorts(ports, match) {
+    const vendorId = normalizeUsbId(match.vendorId);
+    const productId = normalizeUsbId(match.productId);
+    const location = match.location?.startsWith(`${BY_PATH_DIR}/`)
+        ? match.location.slice(BY_PATH_DIR.length + 1)
+        : match.location;
+    return ports.filter((port) => vendorId !== undefined &&
+        port.vendorId === vendorId &&
+        productId !== undefined &&
+        port.productId === productId &&
+        (match.serialNumber === undefined || port.serialNumber === match.serialNumber) &&
+        (location === undefined || port.locations.includes(location)));
+}
+/** `1A86`, `0x1a86` and `1a86` become `1a86`; `403` becomes `0403` */
+function normalizeUsbId(id) {
+    const hex = id?.match(/^(?:0x)?([0-9a-f]{1,4})$/i)?.[1];
+    return hex?.toLowerCase().padStart(4, '0');
+}
+function toPortInfo(port, locations) {
+    const vendorId = normalizeUsbId(port.vendorId);
+    const productId = normalizeUsbId(port.productId);
+    return {
+        path: port.path,
+        ...(vendorId ? { vendorId } : {}),
+        ...(productId ? { productId } : {}),
+        ...(port.serialNumber ? { serialNumber: port.serialNumber } : {}),
+        ...(port.manufacturer ? { manufacturer: port.manufacturer } : {}),
+        locations,
+    };
+}
+async function listPorts(system) {
+    try {
+        return await listSysfsPorts(system);
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+        return system.list();
+    }
+}
+function isNotFound(error) {
+    return error.code === 'ENOENT';
+}
+/** Map each device path to the names of its links in /dev/serial/by-path */
+async function readLocations(system) {
+    const locations = new Map();
+    let names;
+    try {
+        names = await system.readdir(BY_PATH_DIR);
+    }
+    catch (error) {
+        // udev creates the directory only while a USB serial adapter is plugged in
+        if (isNotFound(error))
+            return locations;
+        throw error;
+    }
+    const sorted = [...names].sort();
+    const targets = await Promise.all(sorted.map((name) => 
+    // A link points nowhere when its adapter is unplugged while listing
+    system.realpath(join(BY_PATH_DIR, name)).catch(() => undefined)));
+    sorted.forEach((name, index) => {
+        const target = targets[index];
+        if (target !== undefined)
+            locations.set(target, [...(locations.get(target) ?? []), name]);
+    });
+    return locations;
+}
+/**
+ * List the ports in /sys/class/tty that belong to a device, and read the USB
+ * identity of the USB device above each one
+ */
+async function listSysfsPorts(system) {
+    const names = await system.readdir(SYS_TTY_DIR);
+    const ports = await Promise.all(names.map(async (name) => {
+        // Virtual terminals (tty0, console, ptmx) have no device
+        const device = await system.realpath(join(SYS_TTY_DIR, name, 'device')).catch(() => undefined);
+        return device === undefined
+            ? undefined
+            : { path: join('/dev', name), ...(await readUsbIdentity(system, device)) };
+    }));
+    return ports.filter((port) => port !== undefined);
+}
+/** Walk up from a tty device to the USB device, which has the idVendor file */
+async function readUsbIdentity(system, device) {
+    for (let dir = device; dir !== dirname(dir); dir = dirname(dir)) {
+        const vendorId = await readAttribute(system, dir, 'idVendor');
+        if (vendorId === undefined)
+            continue;
+        return {
+            vendorId,
+            productId: await readAttribute(system, dir, 'idProduct'),
+            serialNumber: await readAttribute(system, dir, 'serial'),
+            manufacturer: await readAttribute(system, dir, 'manufacturer'),
+        };
+    }
+    return {};
+}
+/**
+ * Read a sysfs attribute without the newline that sysfs adds, or undefined
+ * when the device does not have it
+ */
+function readAttribute(system, dir, name) {
+    return system.readFile(join(dir, name)).then((value) => value.replace(/\n$/, ''), () => undefined);
+}
+//# sourceMappingURL=serial-ports.js.map

package/dist/esm/src/serial-ports.js.map

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