node-ch347 0.0.1

package/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

package/README.md

@@ -0,0 +1,234 @@
+# node-ch347
+
+A Node.js library for interfacing with WCH CH347 USB devices. Supports GPIO control and SPI flash programming.
+
+> **Note:** This is an early release (v0.0.1). The API may change in future versions.
+
+## Features
+
+- **GPIO Control**: 8 GPIO channels with input/output support
+- **SPI Flash Programming**: Read, write, erase, and verify SPI flash chips
+  - Supports common chips: W25Qxx, GD25Qxx, MX25Lxx, MT25Qxx, etc.
+  - JEDEC ID detection
+  - Sector (4KB), block (32KB/64KB), and chip erase
+- **UART Path Discovery**: Get the serial port path for use with external libraries
+- **Cross-Platform**: Works on Linux and macOS
+
+## Installation
+
+```bash
+npm install node-ch347
+```
+
+### Prerequisites
+
+**Linux:**
+```bash
+# Install libusb
+sudo apt-get install libusb-1.0-0-dev
+
+# Add udev rules for non-root access
+sudo tee /etc/udev/rules.d/99-ch347.rules << EOF
+SUBSYSTEM=="usb", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="55db", MODE="0666"
+EOF
+sudo udevadm control --reload-rules
+sudo udevadm trigger
+```
+
+**macOS:**
+```bash
+# Install libusb via Homebrew
+brew install libusb
+```
+
+## Quick Start
+
+```typescript
+import CH347Device, { SPISpeed } from 'node-ch347';
+
+async function main() {
+  // Create device instance
+  const ch347 = new CH347Device({
+    spi: { speed: SPISpeed.CLK_15M }
+  });
+
+  // Open connection
+  await ch347.open();
+
+  // GPIO: Set pin 3 high
+  await ch347.gpioWrite(3, true);
+
+  // SPI Flash: Read chip ID
+  const flashInfo = await ch347.flashReadId();
+  console.log(`Flash: ${flashInfo.name}, ${flashInfo.size / 1024 / 1024} MB`);
+
+  // SPI Flash: Read data
+  const data = await ch347.flashRead(0, 4096);
+
+  // Close connection
+  ch347.close();
+}
+```
+
+## API Reference
+
+### CH347Device
+
+Main class that provides unified access to all functionality.
+
+```typescript
+const device = new CH347Device(options?: {
+  spi?: Partial<SPIConfig>;
+});
+```
+
+#### Static Methods
+
+- `CH347Device.listDevices()`: List all connected CH347 devices
+
+#### Instance Methods
+
+**Connection:**
+- `open(deviceIndex?: number)`: Open device connection
+- `close()`: Close connection
+- `isConnected()`: Check if connected
+- `getUARTPath()`: Get the tty path for this device (e.g., `/dev/ttyACM0`)
+
+**GPIO:**
+- `gpioReadAll()`: Read all GPIO pin states
+- `gpioRead(pin)`: Read single GPIO pin
+- `gpioWrite(pin, value)`: Set GPIO output
+- `gpioPulse(pin, duration, activeHigh)`: Pulse GPIO pin
+
+**SPI Flash:**
+- `spiInit(config?)`: Initialize SPI interface
+- `flashReadId()`: Read JEDEC ID
+- `flashRead(address, length, onProgress?)`: Read data
+- `flashWrite(address, data, onProgress?)`: Write data
+- `flashEraseSector(address)`: Erase 4KB sector
+- `flashEraseChip(onProgress?)`: Erase entire chip
+- `flashProgram(address, data, options?)`: Erase + write + verify
+- `flashProgramFile(filePath, address?, options?)`: Program flash from binary file (if address omitted, file size must match flash size)
+- `flashReadToFile(filePath, address?, length?, onProgress?)`: Read flash to binary file
+
+### SPI Configuration
+
+```typescript
+interface SPIConfig {
+  speed: SPISpeed;      // Clock speed (default: CLK_15M)
+  mode: SPIMode;        // SPI mode 0-3 (default: MODE_0)
+  chipSelect: 0 | 1;    // CS line (default: 0)
+  bitOrder: 'MSB' | 'LSB'; // Bit order (default: 'MSB')
+}
+
+enum SPISpeed {
+  CLK_60M = 0,
+  CLK_30M = 1,
+  CLK_15M = 2,
+  CLK_7_5M = 3,
+  CLK_3_75M = 4,
+  CLK_1_875M = 5,
+  CLK_937_5K = 6,
+  CLK_468_75K = 7,
+}
+```
+
+## Examples
+
+### GPIO Control
+
+```typescript
+import CH347Device from 'node-ch347';
+
+const ch347 = new CH347Device();
+await ch347.open();
+
+// Read all GPIO states
+const states = await ch347.gpioReadAll();
+states.forEach(s => console.log(`GPIO${s.pin}: ${s.value}`));
+
+// Set output on pin 3
+await ch347.gpioWrite(3, true);
+
+// Pulse pin 0 (for button press simulation)
+await ch347.gpioPulse(0, 100);
+
+ch347.close();
+```
+
+### Flash Programming
+
+```typescript
+import CH347Device, { SPISpeed } from 'node-ch347';
+
+const ch347 = new CH347Device({ spi: { speed: SPISpeed.CLK_30M } });
+await ch347.open();
+
+// Detect flash
+const info = await ch347.flashReadId();
+console.log(`Detected: ${info.name}`);
+
+// Backup flash to file
+await ch347.flashReadToFile('backup.bin', 0, info.size, (p) => {
+  console.log(`Reading: ${p.percentage}%`);
+});
+
+// Program flash from file (erase + write + verify)
+await ch347.flashProgramFile('new_firmware.bin', 0, {
+  erase: true,
+  verify: true,
+  onProgress: (p) => console.log(`${p.operation}: ${p.percentage}%`)
+});
+
+ch347.close();
+```
+
+### UART Path Discovery
+
+The library provides UART path discovery. Use an external serial library like `serialport` for actual communication:
+
+```typescript
+import CH347Device from 'node-ch347';
+import { SerialPort } from 'serialport'; // npm install serialport
+
+const ch347 = new CH347Device();
+await ch347.open();
+
+// Get UART path for this device
+const uartPath = ch347.getUARTPath();
+console.log('UART path:', uartPath); // e.g., '/dev/ttyACM0'
+
+// Use serialport library for UART communication
+if (uartPath) {
+  const port = new SerialPort({ path: uartPath, baudRate: 115200 });
+  port.write('AT\r\n');
+  // ... handle data with port.on('data', ...)
+}
+
+ch347.close();
+```
+
+## CH347 Hardware
+
+The CH347 is a USB 2.0 high-speed (480 Mbps) bus converter chip by WCH (Nanjing Qinheng Microelectronics).
+
+**Supported mode:**
+- Mode 1 (PID 0x55DB): UART + SPI + I2C + GPIO
+
+**Pin assignments for GPIO (Mode 1):**
+- GPIO0: CTS0/SCK/TCK
+- GPIO1: RTS0/MISO/TDO
+- GPIO2: DSR0/SCS0/TMS
+- GPIO3: SCL
+- GPIO4: ACT
+- GPIO5: DTR0/TNOW0/SCS1/TRST
+- GPIO6: CTS1
+- GPIO7: RTS1
+
+## Disclaimer
+
+This project was developed with AI-assisted code generation. Not all functions have been fully tested. Use at your own risk.
+
+## License
+
+This project is released into the public domain under [The Unlicense](LICENSE).

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CH347 Device Configuration
+ *
+ * Functions to list CH347 devices with their serial numbers.
+ */
+export interface CH347DeviceWithSerial {
+    index: number;
+    vendorId: number;
+    productId: number;
+    busNumber: number;
+    deviceAddress: number;
+    serialNumber: string | null;
+    manufacturer: string | null;
+    product: string | null;
+}
+/**
+ * List all connected CH347 devices with their serial numbers
+ */
+export declare function listDevicesWithSerial(): Promise<CH347DeviceWithSerial[]>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * CH347 Device Configuration
+ *
+ * Functions to list CH347 devices with their serial numbers.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDevicesWithSerial = listDevicesWithSerial;
+const usb = __importStar(require("usb"));
+const constants_1 = require("./constants");
+/**
+ * List all connected CH347 devices with their serial numbers
+ */
+async function listDevicesWithSerial() {
+    const devices = [];
+    const allDevices = usb.getDeviceList();
+    let index = 0;
+    for (const device of allDevices) {
+        const desc = device.deviceDescriptor;
+        if (desc.idVendor === constants_1.CH347_VID &&
+            (desc.idProduct === constants_1.CH347_PID_SPI_I2C_UART ||
+                desc.idProduct === constants_1.CH347_PID_JTAG_I2C_UART)) {
+            const info = {
+                index,
+                vendorId: desc.idVendor,
+                productId: desc.idProduct,
+                busNumber: device.busNumber,
+                deviceAddress: device.deviceAddress,
+                serialNumber: null,
+                manufacturer: null,
+                product: null,
+            };
+            // Try to read string descriptors
+            try {
+                device.open();
+                if (desc.iSerialNumber) {
+                    info.serialNumber = await getStringDescriptor(device, desc.iSerialNumber);
+                }
+                if (desc.iManufacturer) {
+                    info.manufacturer = await getStringDescriptor(device, desc.iManufacturer);
+                }
+                if (desc.iProduct) {
+                    info.product = await getStringDescriptor(device, desc.iProduct);
+                }
+                device.close();
+            }
+            catch {
+                // Device may be in use or require permissions
+                try {
+                    device.close();
+                }
+                catch {
+                    // Ignore close errors
+                }
+            }
+            devices.push(info);
+            index++;
+        }
+    }
+    return devices;
+}
+/**
+ * Get USB string descriptor
+ */
+function getStringDescriptor(device, index) {
+    return new Promise((resolve, reject) => {
+        device.getStringDescriptor(index, (err, data) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(data ?? '');
+            }
+        });
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/constants.d.ts

@@ -0,0 +1,83 @@
+/**
+ * CH347 USB Constants and Protocol Definitions
+ */
+export declare const CH347_VID = 6790;
+export declare const CH347_PID_SPI_I2C_UART = 21979;
+export declare const CH347_PID_JTAG_I2C_UART = 21981;
+export declare const CH347_EP_OUT = 6;
+export declare const CH347_EP_IN = 134;
+export declare const CH347_IFACE_SPI_I2C_GPIO = 2;
+export declare const CH347_IFACE_UART = 0;
+export declare const CH347_PACKET_SIZE = 512;
+export declare const CH347_MAX_PAYLOAD = 507;
+export declare const CH347_TIMEOUT_MS = 1000;
+export declare const CH347_CMD_GPIO = 204;
+export declare const CH347_GPIO_COUNT = 8;
+export declare const GPIO_PIN_ENABLE = 192;
+export declare const GPIO_PIN_DIR_OUT = 48;
+export declare const GPIO_PIN_VALUE_HIGH = 8;
+export declare const GPIO_PIN_IS_OUTPUT = 128;
+export declare const GPIO_PIN_VALUE = 64;
+export declare const CH347_CMD_I2C_STREAM = 170;
+export declare const CH347_CMD_I2C_STM_END = 0;
+export declare const CH347_CMD_I2C_STM_STA = 116;
+export declare const CH347_CMD_I2C_STM_STO = 117;
+export declare const CH347_CMD_I2C_STM_OUT = 128;
+export declare const CH347_CMD_I2C_STM_IN = 192;
+export declare const CH347_CMD_I2C_STM_SET = 96;
+export declare enum I2CSpeed {
+    LOW = 0,// 20kHz
+    STANDARD = 1,// 100kHz
+    FAST = 2,// 400kHz
+    HIGH = 3
+}
+export declare const CH347_CMD_SPI_SET_CFG = 192;
+export declare const CH347_CMD_SPI_CS_CTRL = 193;
+export declare const CH347_CMD_SPI_OUT_IN = 194;
+export declare const CH347_CMD_SPI_IN = 195;
+export declare const CH347_CMD_SPI_OUT = 196;
+export declare const CH347_CMD_SPI_GET_CFG = 202;
+export declare const CH347_CS_ASSERT = 0;
+export declare const CH347_CS_DEASSERT = 64;
+export declare const CH347_CS_CHANGE = 128;
+export declare const CH347_CS_IGNORE = 0;
+export declare enum SPISpeed {
+    CLK_60M = 0,
+    CLK_30M = 1,
+    CLK_15M = 2,
+    CLK_7_5M = 3,
+    CLK_3_75M = 4,
+    CLK_1_875M = 5,
+    CLK_937_5K = 6,
+    CLK_468_75K = 7
+}
+export declare enum SPIMode {
+    MODE_0 = 0,// CPOL=0, CPHA=0
+    MODE_1 = 1,// CPOL=0, CPHA=1
+    MODE_2 = 2,// CPOL=1, CPHA=0
+    MODE_3 = 3
+}
+export declare const FLASH_CMD_WRITE_ENABLE = 6;
+export declare const FLASH_CMD_WRITE_DISABLE = 4;
+export declare const FLASH_CMD_READ_STATUS = 5;
+export declare const FLASH_CMD_WRITE_STATUS = 1;
+export declare const FLASH_CMD_READ_DATA = 3;
+export declare const FLASH_CMD_FAST_READ = 11;
+export declare const FLASH_CMD_PAGE_PROGRAM = 2;
+export declare const FLASH_CMD_SECTOR_ERASE = 32;
+export declare const FLASH_CMD_BLOCK_ERASE_32K = 82;
+export declare const FLASH_CMD_BLOCK_ERASE_64K = 216;
+export declare const FLASH_CMD_CHIP_ERASE = 199;
+export declare const FLASH_CMD_READ_ID = 159;
+export declare const FLASH_CMD_READ_JEDEC_ID = 159;
+export declare const FLASH_CMD_POWER_DOWN = 185;
+export declare const FLASH_CMD_RELEASE_POWER_DOWN = 171;
+export declare const FLASH_CMD_READ_SFDP = 90;
+export declare const FLASH_STATUS_WIP = 1;
+export declare const FLASH_STATUS_WEL = 2;
+export declare const FLASH_PAGE_SIZE = 256;
+export declare const FLASH_SECTOR_SIZE = 4096;
+export declare const FLASH_BLOCK_SIZE_32K = 32768;
+export declare const FLASH_BLOCK_SIZE_64K = 65536;
+export declare const CH347_UART_DEFAULT_BAUD = 115200;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * CH347 USB Constants and Protocol Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLASH_CMD_READ_JEDEC_ID = exports.FLASH_CMD_READ_ID = exports.FLASH_CMD_CHIP_ERASE = exports.FLASH_CMD_BLOCK_ERASE_64K = exports.FLASH_CMD_BLOCK_ERASE_32K = exports.FLASH_CMD_SECTOR_ERASE = exports.FLASH_CMD_PAGE_PROGRAM = exports.FLASH_CMD_FAST_READ = exports.FLASH_CMD_READ_DATA = exports.FLASH_CMD_WRITE_STATUS = exports.FLASH_CMD_READ_STATUS = exports.FLASH_CMD_WRITE_DISABLE = exports.FLASH_CMD_WRITE_ENABLE = exports.SPIMode = exports.SPISpeed = exports.CH347_CS_IGNORE = exports.CH347_CS_CHANGE = exports.CH347_CS_DEASSERT = exports.CH347_CS_ASSERT = exports.CH347_CMD_SPI_GET_CFG = exports.CH347_CMD_SPI_OUT = exports.CH347_CMD_SPI_IN = exports.CH347_CMD_SPI_OUT_IN = exports.CH347_CMD_SPI_CS_CTRL = exports.CH347_CMD_SPI_SET_CFG = exports.I2CSpeed = exports.CH347_CMD_I2C_STM_SET = exports.CH347_CMD_I2C_STM_IN = exports.CH347_CMD_I2C_STM_OUT = exports.CH347_CMD_I2C_STM_STO = exports.CH347_CMD_I2C_STM_STA = exports.CH347_CMD_I2C_STM_END = exports.CH347_CMD_I2C_STREAM = exports.GPIO_PIN_VALUE = exports.GPIO_PIN_IS_OUTPUT = exports.GPIO_PIN_VALUE_HIGH = exports.GPIO_PIN_DIR_OUT = exports.GPIO_PIN_ENABLE = exports.CH347_GPIO_COUNT = exports.CH347_CMD_GPIO = exports.CH347_TIMEOUT_MS = exports.CH347_MAX_PAYLOAD = exports.CH347_PACKET_SIZE = exports.CH347_IFACE_UART = exports.CH347_IFACE_SPI_I2C_GPIO = exports.CH347_EP_IN = exports.CH347_EP_OUT = exports.CH347_PID_JTAG_I2C_UART = exports.CH347_PID_SPI_I2C_UART = exports.CH347_VID = void 0;
+exports.CH347_UART_DEFAULT_BAUD = exports.FLASH_BLOCK_SIZE_64K = exports.FLASH_BLOCK_SIZE_32K = exports.FLASH_SECTOR_SIZE = exports.FLASH_PAGE_SIZE = exports.FLASH_STATUS_WEL = exports.FLASH_STATUS_WIP = exports.FLASH_CMD_READ_SFDP = exports.FLASH_CMD_RELEASE_POWER_DOWN = exports.FLASH_CMD_POWER_DOWN = void 0;
+// USB Vendor and Product IDs
+exports.CH347_VID = 0x1a86;
+exports.CH347_PID_SPI_I2C_UART = 0x55db; // Mode 1: SPI + I2C + UART
+exports.CH347_PID_JTAG_I2C_UART = 0x55dd; // Mode 3: JTAG + I2C + UART
+// USB Endpoints (Mode 1 - SPI/I2C/GPIO interface is on interface 2)
+exports.CH347_EP_OUT = 0x06;
+exports.CH347_EP_IN = 0x86;
+exports.CH347_IFACE_SPI_I2C_GPIO = 2;
+exports.CH347_IFACE_UART = 0; // UART is typically on interface 0
+// USB Transfer Constants
+exports.CH347_PACKET_SIZE = 512;
+exports.CH347_MAX_PAYLOAD = 507; // 512 - 3 (cmd + length) - 2 (padding)
+exports.CH347_TIMEOUT_MS = 1000;
+// GPIO Commands
+exports.CH347_CMD_GPIO = 0xcc;
+exports.CH347_GPIO_COUNT = 8;
+// GPIO Pin Bit Masks (for gpio_obuf[3 + pin])
+exports.GPIO_PIN_ENABLE = 0xc0; // Enable pin change
+exports.GPIO_PIN_DIR_OUT = 0x30; // Set direction to output
+exports.GPIO_PIN_VALUE_HIGH = 0x08; // Set value high
+// GPIO Response Bit Masks (for gpio_ibuf[3 + pin])
+exports.GPIO_PIN_IS_OUTPUT = 0x80; // Direction is output
+exports.GPIO_PIN_VALUE = 0x40; // Current value
+// I2C Commands
+exports.CH347_CMD_I2C_STREAM = 0xaa;
+exports.CH347_CMD_I2C_STM_END = 0x00;
+exports.CH347_CMD_I2C_STM_STA = 0x74; // Start condition
+exports.CH347_CMD_I2C_STM_STO = 0x75; // Stop condition
+exports.CH347_CMD_I2C_STM_OUT = 0x80; // Output data (| length)
+exports.CH347_CMD_I2C_STM_IN = 0xc0; // Input data (| length)
+exports.CH347_CMD_I2C_STM_SET = 0x60; // Set speed (| speed)
+// I2C Speed modes
+var I2CSpeed;
+(function (I2CSpeed) {
+    I2CSpeed[I2CSpeed["LOW"] = 0] = "LOW";
+    I2CSpeed[I2CSpeed["STANDARD"] = 1] = "STANDARD";
+    I2CSpeed[I2CSpeed["FAST"] = 2] = "FAST";
+    I2CSpeed[I2CSpeed["HIGH"] = 3] = "HIGH";
+})(I2CSpeed || (exports.I2CSpeed = I2CSpeed = {}));
+// SPI Commands (from flashrom ch347_spi.c)
+exports.CH347_CMD_SPI_SET_CFG = 0xc0;
+exports.CH347_CMD_SPI_CS_CTRL = 0xc1;
+exports.CH347_CMD_SPI_OUT_IN = 0xc2;
+exports.CH347_CMD_SPI_IN = 0xc3;
+exports.CH347_CMD_SPI_OUT = 0xc4;
+exports.CH347_CMD_SPI_GET_CFG = 0xca;
+// SPI Chip Select Control
+exports.CH347_CS_ASSERT = 0x00;
+exports.CH347_CS_DEASSERT = 0x40;
+exports.CH347_CS_CHANGE = 0x80;
+exports.CH347_CS_IGNORE = 0x00;
+// SPI Clock Speeds (divisor values)
+var SPISpeed;
+(function (SPISpeed) {
+    SPISpeed[SPISpeed["CLK_60M"] = 0] = "CLK_60M";
+    SPISpeed[SPISpeed["CLK_30M"] = 1] = "CLK_30M";
+    SPISpeed[SPISpeed["CLK_15M"] = 2] = "CLK_15M";
+    SPISpeed[SPISpeed["CLK_7_5M"] = 3] = "CLK_7_5M";
+    SPISpeed[SPISpeed["CLK_3_75M"] = 4] = "CLK_3_75M";
+    SPISpeed[SPISpeed["CLK_1_875M"] = 5] = "CLK_1_875M";
+    SPISpeed[SPISpeed["CLK_937_5K"] = 6] = "CLK_937_5K";
+    SPISpeed[SPISpeed["CLK_468_75K"] = 7] = "CLK_468_75K";
+})(SPISpeed || (exports.SPISpeed = SPISpeed = {}));
+// SPI Modes
+var SPIMode;
+(function (SPIMode) {
+    SPIMode[SPIMode["MODE_0"] = 0] = "MODE_0";
+    SPIMode[SPIMode["MODE_1"] = 1] = "MODE_1";
+    SPIMode[SPIMode["MODE_2"] = 2] = "MODE_2";
+    SPIMode[SPIMode["MODE_3"] = 3] = "MODE_3";
+})(SPIMode || (exports.SPIMode = SPIMode = {}));
+// SPI Flash Commands (common JEDEC commands)
+exports.FLASH_CMD_WRITE_ENABLE = 0x06;
+exports.FLASH_CMD_WRITE_DISABLE = 0x04;
+exports.FLASH_CMD_READ_STATUS = 0x05;
+exports.FLASH_CMD_WRITE_STATUS = 0x01;
+exports.FLASH_CMD_READ_DATA = 0x03;
+exports.FLASH_CMD_FAST_READ = 0x0b;
+exports.FLASH_CMD_PAGE_PROGRAM = 0x02;
+exports.FLASH_CMD_SECTOR_ERASE = 0x20; // 4KB
+exports.FLASH_CMD_BLOCK_ERASE_32K = 0x52; // 32KB
+exports.FLASH_CMD_BLOCK_ERASE_64K = 0xd8; // 64KB
+exports.FLASH_CMD_CHIP_ERASE = 0xc7;
+exports.FLASH_CMD_READ_ID = 0x9f;
+exports.FLASH_CMD_READ_JEDEC_ID = 0x9f;
+exports.FLASH_CMD_POWER_DOWN = 0xb9;
+exports.FLASH_CMD_RELEASE_POWER_DOWN = 0xab;
+exports.FLASH_CMD_READ_SFDP = 0x5a; // Read SFDP (Serial Flash Discoverable Parameters)
+// Flash Status Register Bits
+exports.FLASH_STATUS_WIP = 0x01; // Write In Progress
+exports.FLASH_STATUS_WEL = 0x02; // Write Enable Latch
+// Flash Constants
+exports.FLASH_PAGE_SIZE = 256;
+exports.FLASH_SECTOR_SIZE = 4096;
+exports.FLASH_BLOCK_SIZE_32K = 32768;
+exports.FLASH_BLOCK_SIZE_64K = 65536;
+// UART interface - uses CDC ACM protocol via serial port
+// The CH347 UART appears as a virtual COM port
+exports.CH347_UART_DEFAULT_BAUD = 115200;
+//# sourceMappingURL=constants.js.map