esp32tool 1.1.8 → 1.2.0

package/dist/index.d.ts

@@ -2,8 +2,9 @@ import { Logger } from "./const";
 import { ESPLoader } from "./esp_loader";
 export type { Logger } from "./const";
 export { ESPLoader } from "./esp_loader";
-export { CHIP_FAMILY_ESP32, CHIP_FAMILY_ESP32S2, CHIP_FAMILY_ESP32S3, CHIP_FAMILY_ESP8266, CHIP_FAMILY_ESP32C2, CHIP_FAMILY_ESP32C3, CHIP_FAMILY_ESP32C5, CHIP_FAMILY_ESP32C6, CHIP_FAMILY_ESP32C61, CHIP_FAMILY_ESP32H2, CHIP_FAMILY_ESP32H4, CHIP_FAMILY_ESP32H21, CHIP_FAMILY_ESP32P4, CHIP_FAMILY_ESP32S31, } from "./const";
+export { CHIP_FAMILY_ESP32, CHIP_FAMILY_ESP32S2, CHIP_FAMILY_ESP32S3, CHIP_FAMILY_ESP8266, CHIP_FAMILY_ESP32C2, CHIP_FAMILY_ESP32C3, CHIP_FAMILY_ESP32C5, CHIP_FAMILY_ESP32C6, CHIP_FAMILY_ESP32C61, CHIP_FAMILY_ESP32H2, CHIP_FAMILY_ESP32H4, CHIP_FAMILY_ESP32H21, CHIP_FAMILY_ESP32P4, CHIP_FAMILY_ESP32S31, ESP_FLASH_BEGIN, ESP_FLASH_DATA, ESP_FLASH_END, ESP_MEM_BEGIN, ESP_MEM_END, ESP_MEM_DATA, ESP_SYNC, ESP_WRITE_REG, ESP_READ_REG, ESP_ERASE_FLASH, ESP_ERASE_REGION, ESP_READ_FLASH, ESP_SPI_SET_PARAMS, ESP_SPI_ATTACH, ESP_CHANGE_BAUDRATE, ESP_SPI_FLASH_MD5, ESP_GET_SECURITY_INFO, ESP_CHECKSUM_MAGIC, ESP_FLASH_DEFL_BEGIN, ESP_FLASH_DEFL_DATA, ESP_FLASH_DEFL_END, ROM_INVALID_RECV_MSG, USB_RAM_BLOCK, ESP_RAM_BLOCK, DEFAULT_TIMEOUT, CHIP_ERASE_TIMEOUT, MAX_TIMEOUT, SYNC_TIMEOUT, ERASE_REGION_TIMEOUT_PER_MB, MEM_END_ROM_TIMEOUT, FLASH_READ_TIMEOUT, } from "./const";
 export declare const connect: (logger: Logger) => Promise<ESPLoader>;
+export declare const connectWithPort: (port: SerialPort, logger: Logger) => Promise<ESPLoader>;
 export { parsePartitionTable, getPartitionTableOffset, formatSize, } from "./partition";
 export type { Partition } from "./partition";
 export { FilesystemType, detectFilesystemType, detectFilesystemFromImage, getDefaultBlockSize, getBlockSizeCandidates, getESP8266FilesystemLayout, scanESP8266Filesystem, LITTLEFS_DEFAULT_BLOCK_SIZE, LITTLEFS_BLOCK_SIZE_CANDIDATES, FATFS_DEFAULT_BLOCK_SIZE, FATFS_BLOCK_SIZE_CANDIDATES, ESP8266_LITTLEFS_BLOCK_SIZE, ESP8266_LITTLEFS_BLOCK_SIZE_CANDIDATES, ESP8266_LITTLEFS_PAGE_SIZE, ESP8266_SPIFFS_PAGE_SIZE, ESP8266_SPIFFS_BLOCK_SIZE, } from "./wasm/filesystems";

package/dist/index.js

@@ -2,12 +2,45 @@
 import { ESP_ROM_BAUD } from "./const";
 import { ESPLoader } from "./esp_loader";
 export { ESPLoader } from "./esp_loader";
-export { CHIP_FAMILY_ESP32, CHIP_FAMILY_ESP32S2, CHIP_FAMILY_ESP32S3, CHIP_FAMILY_ESP8266, CHIP_FAMILY_ESP32C2, CHIP_FAMILY_ESP32C3, CHIP_FAMILY_ESP32C5, CHIP_FAMILY_ESP32C6, CHIP_FAMILY_ESP32C61, CHIP_FAMILY_ESP32H2, CHIP_FAMILY_ESP32H4, CHIP_FAMILY_ESP32H21, CHIP_FAMILY_ESP32P4, CHIP_FAMILY_ESP32S31, } from "./const";
+export { CHIP_FAMILY_ESP32, CHIP_FAMILY_ESP32S2, CHIP_FAMILY_ESP32S3, CHIP_FAMILY_ESP8266, CHIP_FAMILY_ESP32C2, CHIP_FAMILY_ESP32C3, CHIP_FAMILY_ESP32C5, CHIP_FAMILY_ESP32C6, CHIP_FAMILY_ESP32C61, CHIP_FAMILY_ESP32H2, CHIP_FAMILY_ESP32H4, CHIP_FAMILY_ESP32H21, CHIP_FAMILY_ESP32P4, CHIP_FAMILY_ESP32S31, 
+// Command constants
+ESP_FLASH_BEGIN, ESP_FLASH_DATA, ESP_FLASH_END, ESP_MEM_BEGIN, ESP_MEM_END, ESP_MEM_DATA, ESP_SYNC, ESP_WRITE_REG, ESP_READ_REG, ESP_ERASE_FLASH, ESP_ERASE_REGION, ESP_READ_FLASH, ESP_SPI_SET_PARAMS, ESP_SPI_ATTACH, ESP_CHANGE_BAUDRATE, ESP_SPI_FLASH_MD5, ESP_GET_SECURITY_INFO, ESP_CHECKSUM_MAGIC, ESP_FLASH_DEFL_BEGIN, ESP_FLASH_DEFL_DATA, ESP_FLASH_DEFL_END, ROM_INVALID_RECV_MSG, 
+// Block size constants
+USB_RAM_BLOCK, ESP_RAM_BLOCK, 
+// Timeout constants
+DEFAULT_TIMEOUT, CHIP_ERASE_TIMEOUT, MAX_TIMEOUT, SYNC_TIMEOUT, ERASE_REGION_TIMEOUT_PER_MB, MEM_END_ROM_TIMEOUT, FLASH_READ_TIMEOUT, } from "./const";
 export const connect = async (logger) => {
     // - Request a port and open a connection.
-    const port = await navigator.serial.requestPort();
-    await port.open({ baudRate: ESP_ROM_BAUD });
-    logger.log("Connected successfully.");
+    // Try to use requestSerialPort if available (supports WebUSB for Android)
+    let port;
+    const customRequestPort = globalThis.requestSerialPort;
+    if (typeof customRequestPort === "function") {
+        port = await customRequestPort();
+    }
+    else {
+        // Check if Web Serial API is available
+        if (!navigator.serial) {
+            throw new Error("Web Serial API is not supported in this browser. " +
+                "Please use Chrome, Edge, or Opera on desktop, or Chrome on Android. " +
+                "Note: The page must be served over HTTPS or localhost.");
+        }
+        port = await navigator.serial.requestPort();
+    }
+    // Only open if not already open (requestSerialPort may return an opened port)
+    if (!port.readable || !port.writable) {
+        await port.open({ baudRate: ESP_ROM_BAUD });
+    }
+    return new ESPLoader(port, logger);
+};
+export const connectWithPort = async (port, logger) => {
+    // Connect using an already opened port (useful for WebUSB wrapper)
+    if (!port) {
+        throw new Error("Port is required");
+    }
+    // Check if port is already open, if not open it
+    if (!port.readable || !port.writable) {
+        await port.open({ baudRate: ESP_ROM_BAUD });
+    }
     return new ESPLoader(port, logger);
 };
 export { parsePartitionTable, getPartitionTableOffset, formatSize, } from "./partition";

package/dist/node-usb-adapter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Node.js USB Adapter
+ *
+ * Uses node-usb to directly control USB-Serial chips (CP2102, CH340, FTDI, etc.)
+ * This provides the same level of control as WebUSB and avoids node-serialport issues
+ */
+import { Logger } from "./const";
+import type { Device } from "usb";
+export interface NodeUSBPort {
+    readable: ReadableStream<Uint8Array> | null;
+    writable: WritableStream<Uint8Array> | null;
+    isWebUSB?: boolean;
+    open(options: {
+        baudRate: number;
+    }): Promise<void>;
+    close(): Promise<void>;
+    setSignals(signals: {
+        dataTerminalReady?: boolean;
+        requestToSend?: boolean;
+        break?: boolean;
+    }): Promise<void>;
+    setBaudRate(baudRate: number): Promise<void>;
+    getSignals(): Promise<{
+        dataCarrierDetect: boolean;
+        clearToSend: boolean;
+        ringIndicator: boolean;
+        dataSetReady: boolean;
+    }>;
+    getInfo(): {
+        usbVendorId?: number;
+        usbProductId?: number;
+    };
+}
+/**
+ * Create a Web Serial API compatible port from node-usb Device
+ */
+export declare function createNodeUSBAdapter(device: Device, logger: Logger): NodeUSBPort;
+/**
+ * List available USB serial devices
+ */
+export declare function listUSBPorts(): Promise<Array<{
+    path: string;
+    manufacturer?: string;
+    serialNumber?: string;
+    vendorId?: string;
+    productId?: string;
+}>>;